@devvit/public-api 0.11.0-next-2024-07-30-8f65a4fa6.0 → 0.11.0-next-2024-07-30-0415fdb14.0

package/public-api.d.ts

@@ -45978,6 +45978,18 @@ export declare type RedisClient = {
      * Marks the given keys to be watched for conditional execution of a transaction.
      * https://redis.io/commands/watch/
      * @arg {} keys - given keys to be watched
+     * @example
+     * ```ts
+     * async function watchExample(context: Devvit.Context) {
+     *  await context.redis.set("karma", "32");
+     *
+     *  const txn = await context.redis.watch("quantity");
+     *
+     *  await txn.multi();  // Begin a transaction
+     *  await txn.incrBy("karma", 10);
+     *  await txn.exec();   // Execute the commands in the transaction
+     * }
+     * ```
      */
     watch(...keys: string[]): Promise<TxClientLike>;
     /**
@@ -45985,6 +45997,14 @@ export declare type RedisClient = {
      * https://redis.io/commands/get/
      * @arg {} key
      * @returns value of key or null when key does not exist.
+     * @example
+     * ```ts
+     * async function getExample(context: Devvit.Context) {
+     *  await context.redis.set("quantity", "5");
+     *  const quantity : string | undefined = await context.redis.get("quantity");
+     *  console.log("Quantity: " + quantity);
+     * }
+     * ```
      */
     get(key: string): Promise<string | undefined>;
     /**
@@ -45993,12 +46013,25 @@ export declare type RedisClient = {
      * @arg {} key
      * @arg {} value
      * @arg {} options
+     * @example
+     * ```ts
+     * async function setExample(context: Devvit.Context) {
+     *  await context.redis.set("quantity", "5");
+     * }
+     * ```
      */
     set(key: string, value: string, options?: SetOptions): Promise<string>;
     /**
      * Removes the specified keys. A key is ignored if it does not exist.
      * https://redis.io/commands/del/
      * @arg {} keys
+     * @example
+     * ```ts
+     * async function delExample(context: Devvit.Context) {
+     *  await context.redis.set("quantity", "5");
+     *  await context.redis.del("quantity");
+     * }
+     * ```
      */
     del(...keys: string[]): Promise<void>;
     /**
@@ -46006,6 +46039,14 @@ export declare type RedisClient = {
      * https://redis.io/commands/type/
      * @arg {} key
      * @returns string representation of the type
+     * @example
+     * ```ts
+     * async function typeExample(context: Devvit.Context) {
+     *  await context.redis.set("quantity", "5");
+     *  const type : string = await context.redis.type("quantity");
+     *  console.log("Key type: " + type);
+     * }
+     * ```
      */
     type(key: string): Promise<string>;
     /**
@@ -46016,6 +46057,14 @@ export declare type RedisClient = {
      * @arg {} start
      * @arg {} end
      * @returns substring determined by offsets [start, end]
+     * @example
+     * ```ts
+     * async function getRangeExample(context: Devvit.Context) {
+     *  await context.redis.set("word", "tacocat");
+     *  const range : string = await context.redis.getRange("word", 0, 3)
+     *  console.log("Range from index 0 to 3: " + range);
+     * }
+     * ```
      */
     getRange(key: string, start: number, end: number): Promise<string>;
     /**
@@ -46025,6 +46074,13 @@ export declare type RedisClient = {
      * @arg {} key
      * @arg {} offset
      * @returns length of the string after it was modified by the command
+     * @example
+     * ```ts
+     * async function setRangeExample(context: Devvit.Context) {
+     *  await context.redis.set("word", "tacocat");
+     *  await context.redis.setRange("word", 0, "blue");
+     * }
+     * ```
      */
     setRange(key: string, offset: number, value: string): Promise<number>;
     /**
@@ -46042,6 +46098,14 @@ export declare type RedisClient = {
      * https://redis.io/commands/strlen/
      * @arg {} key
      * @returns length of the string stored at key
+     * @example
+     * ```ts
+     * async function strLenExample(context: Devvit.Context) {
+     *  await context.redis.set("word", "tacocat");
+     *  const length : number = await context.redis.strLen("word");
+     *  console.log("Length of word: " + length);
+     * }
+     * ```
      */
     strLen(key: string): Promise<number>;
     /**
@@ -46050,6 +46114,14 @@ export declare type RedisClient = {
      * @arg {} key
      * @arg {} value
      * @returns value of key after the increment
+     * @example
+     * ```ts
+     * async function incrByExample(context: Devvit.Context) {
+     *  await context.redis.set("totalPoints", "53")
+     *  const updatedPoints : number = await context.redis.incrBy("totalPoints", 100);
+     *  console.log("Updated points: " + updatedPoints);
+     * }
+     * ```
      */
     incrBy(key: string, value: number): Promise<number>;
     /**
@@ -46065,6 +46137,16 @@ export declare type RedisClient = {
      * https://redis.io/commands/mget/
      * @arg {} keys
      * @returns list of values at the specified keys
+     * @example
+     * ```ts
+     * async function mGetExample(context: Devvit.Context) {
+     *  await context.redis.mSet({"name": "Zeek", "occupation": "Developer"});
+     *  const result : (string | null)[] = await context.redis.mGet(["name", "occupation"]);
+     *  result.forEach(x => {
+     *    console.log(x);
+     *  });
+     * }
+     * ```
      */
     mGet(keys: string[]): Promise<(string | null)[]>;
     /**
@@ -46080,6 +46162,12 @@ export declare type RedisClient = {
      * Sets the given keys to their respective values.
      * https://redis.io/commands/mset/
      * @arg {} keyValues
+     * @example
+     * ```ts
+     * async function mSetExample(context: Devvit.Context) {
+     *  await context.redis.mSet({"name": "Zeek", "occupation": "Developer"});
+     * }
+     * ```
      */
     mSet(keyValues: {
         [key: string]: string;
@@ -46089,6 +46177,13 @@ export declare type RedisClient = {
      * https://redis.io/commands/expire/
      * @arg {} key
      * @arg {} seconds
+     * @example
+     * ```ts
+     * async function expireExample(context: Devvit.Context) {
+     *  await context.redis.set("product", "milk");
+     *  await context.redis.expire("product", 60);   // Set the product to expire in 60 seconds
+     * }
+     * ```
      */
     expire(key: string, seconds: number): Promise<void>;
     /**
@@ -46096,6 +46191,12 @@ export declare type RedisClient = {
      * https://redis.io/commands/expiretime/
      * @arg {} key
      * @returns expiration Unix timestamp in seconds, or a negative value in order to signal an error
+     * @example
+     * async function expireTimeExample(context: Devvit.Context) {
+     *  await context.redis.set("product", "milk");
+     *  const expireTime : number = await context.redis.expireTime("product");
+     *  console.log("Expire time: " + expireTime);
+     * }
      */
     expireTime(key: string): Promise<number>;
     /**
@@ -46103,6 +46204,18 @@ export declare type RedisClient = {
      * https://redis.io/commands/zadd/
      * @arg {} key
      * @returns number of elements added to the sorted set
+     * @example
+     * ```ts
+     * async function zAddExample(context: Devvit.Context) {
+     *  const numMembersAdded : number = await context.redis.zAdd("leaderboard",
+     *    {member: "louis", score: 37},
+     *    {member: "fernando", score: 10},
+     *    {member: "caesar", score: 20},
+     *    {member: "alexander", score: 25},
+     *  );
+     *  console.log("Number of members added: " + numMembersAdded);
+     * }
+     * ```
      */
     zAdd(key: string, ...members: ZMember[]): Promise<number>;
     /**
@@ -46110,6 +46223,19 @@ export declare type RedisClient = {
      * https://redis.io/commands/zcard/
      * @arg {} key
      * @returns cardinality of the sorted set
+     * @example
+     * ```ts
+     * async function zCardExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("leaderboard",
+     *    {member: "louis", score: 37},
+     *    {member: "fernando", score: 10},
+     *    {member: "caesar", score: 20},
+     *    {member: "alexander", score: 25},
+     *  );
+     *  const cardinality : number = await context.redis.zCard("leaderboard");
+     *  console.log("Cardinality: " + cardinality);
+     * }
+     * ```
      */
     zCard(key: string): Promise<number>;
     /**
@@ -46118,6 +46244,19 @@ export declare type RedisClient = {
      * @arg {} key
      * @arg {} member
      * @returns the score of the member (a double-precision floating point number).
+     * @example
+     * ```ts
+     * async function zScoreExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("leaderboard",
+     *    {member: "louis", score: 37},
+     *    {member: "fernando", score: 10},
+     *    {member: "caesar", score: 20},
+     *    {member: "alexander", score: 25},
+     *  );
+     *  const score : number = await context.redis.zScore("leaderboard", "caesar");
+     *  console.log("Caesar's score: " + score);
+     * }
+     * ```
      */
     zScore(key: string, member: string): Promise<number>;
     /**
@@ -46127,6 +46266,19 @@ export declare type RedisClient = {
      * @arg {} member
      * @returns rank of the member. The rank (or index) is 0-based
      * which means that the member with the lowest score has rank 0
+     * @example
+     * ```ts
+     * async function zRankExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("animals",
+     *    {member: "zebra", score: 92},
+     *    {member: "cat", score: 100},
+     *    {member: "dog", score: 95},
+     *    {member: "elephant", score: 97}
+     *  );
+     *  const rank : number = await context.redis.zRank("animals", "dog");
+     *  console.log("Dog's rank: " + rank);
+     * }
+     * ```
      */
     zRank(key: string, member: string): Promise<number>;
     /**
@@ -46136,6 +46288,19 @@ export declare type RedisClient = {
      * @arg {} member
      * @arg {} value
      * @returns the new score of member as a double precision floating point number
+     * @example
+     * ```ts
+     * async function zIncrByExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("animals",
+     *    {member: "zebra", score: 92},
+     *    {member: "cat", score: 100},
+     *    {member: "dog", score: 95},
+     *    {member: "elephant", score: 97}
+     *  );
+     *  const updatedScore : number = await context.redis.zIncrBy("animals", "dog", 10);
+     *  console.log("Dog's updated score: " + updatedScore);
+     * }
+     * ```
      */
     zIncrBy(key: string, member: string, value: number): Promise<number>;
     /**
@@ -46146,6 +46311,24 @@ export declare type RedisClient = {
      * @arg {} stop
      * @arg {} options
      * @returns list of elements in the specified range
+     * @example
+     * ```ts
+     * async function zRangeExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("leaderboard",
+     *    {member: "louis", score: 37},
+     *    {member: "fernando", score: 10},
+     *    {member: "caesar", score: 20},
+     *    {member: "alexander", score: 25},
+     *  );
+     *
+     *  // View elements with scores between 0 and 30 inclusive, sorted by score
+     *  const scores : {member : string, score : number}[] = await context.redis.zRange("leaderboard", 0, 30, { by: "score" });
+     *
+     *  scores.forEach(x => {
+     *    console.log("Member: " + x.member, ", Score: " + x.score);
+     *  });
+     * }
+     * ```
      */
     zRange(key: string, start: number | string, stop: number | string, options?: ZRangeOptions): Promise<{
         member: string;
@@ -46157,6 +46340,19 @@ export declare type RedisClient = {
      * @arg {} key
      * @arg {} members
      * @returns number of members removed from the sorted set
+     * @example
+     * ```ts
+     * async function zRemExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("leaderboard",
+     *    {member: "louis", score: 37},
+     *    {member: "fernando", score: 10},
+     *    {member: "caesar", score: 20},
+     *    {member: "alexander", score: 25},
+     *  );
+     *  const numberOfMembersRemoved : number = await context.redis.zRem("leaderboard", ["fernando", "alexander"]);
+     *  console.log("Number of members removed: " + numberOfMembersRemoved);
+     * }
+     * ```
      */
     zRem(key: string, members: string[]): Promise<number>;
     /**
@@ -46167,6 +46363,23 @@ export declare type RedisClient = {
      * @arg {} min
      * @arg {} max
      * @returns number of members removed from the sorted set
+     * @example
+     * ```ts
+     * async function zRemRangeByLexExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("fruits",
+     *    {member: "kiwi", score: 0},
+     *    {member: "mango", score: 0},
+     *    {member: "banana", score: 0},
+     *    {member: "orange", score: 0},
+     *    {member: "apple", score: 0},
+     *  );
+     *
+     *  // Remove fruits alphabetically ordered between 'kiwi' inclusive and 'orange' exclusive
+     *  // Note: The symbols '[' and '(' indicate inclusive or exclusive, respectively. These must be included in the call to zRemRangeByLex().
+     *  const numFieldsRemoved : number = await context.redis.zRemRangeByLex("fruits", "[kiwi", "(orange");
+     *  console.log("Number of fields removed: " + numFieldsRemoved);
+     * }
+     * ```
      */
     zRemRangeByLex(key: string, min: string, max: string): Promise<number>;
     /**
@@ -46176,6 +46389,22 @@ export declare type RedisClient = {
      * @arg {} start
      * @arg {} stop
      * @returns number of members removed from the sorted set
+     * @example
+     * ```
+     * async function zRemRangeByRankExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("fruits",
+     *    {member: "kiwi", score: 10},
+     *    {member: "mango", score: 20},
+     *    {member: "banana", score: 30},
+     *    {member: "orange", score: 40},
+     *    {member: "apple", score: 50},
+     *  );
+
+     *  // Remove fruits ranked 1 through 3 inclusive
+     *  const numFieldsRemoved : number = await context.redis.zRemRangeByRank("fruits", 1, 3);
+     *  console.log("Number of fields removed: " + numFieldsRemoved);
+     * }
+     * ```
      */
     zRemRangeByRank(key: string, start: number, stop: number): Promise<number>;
     /**
@@ -46185,6 +46414,21 @@ export declare type RedisClient = {
      * @arg {} min
      * @arg {} max
      * @returns number of members removed from the sorted set
+     * @example
+     * ```ts
+     * async function zRemRangeByScoreExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("fruits",
+     *    {member: "kiwi", score: 10},
+     *    {member: "mango", score: 20},
+     *    {member: "banana", score: 30},
+     *    {member: "orange", score: 40},
+     *    {member: "apple", score: 50},
+     *  );
+     *  // Remove fruits scored between 30 and 50 inclusive
+     *  const numFieldsRemoved : number = await context.redis.zRemRangeByScore("fruits", 30, 50);
+     *  console.log("Number of fields removed: " + numFieldsRemoved);
+     * }
+     * ```
      */
     zRemRangeByScore(key: string, min: number, max: number): Promise<number>;
     /**
@@ -46193,6 +46437,20 @@ export declare type RedisClient = {
      * @arg {} cursor
      * @arg {} pattern
      * @arg {} count
+     * @example
+     * ```ts
+     * async function zScanExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("fruits",
+     *    {member: "kiwi", score: 0},
+     *    {member: "mango", score: 0},
+     *    {member: "banana", score: 0},
+     *    {member: "orange", score: 0},
+     *    {member: "apple", score: 0},
+     *  );
+     *  const zScanResponse = await context.redis.zScan("fruits", 0);
+     *  console.log("zScanResponse: " + JSON.stringify(zScanResponse));
+     * }
+     * ```
      */
     zScan(key: string, cursor: number, pattern?: string | undefined, count?: number | undefined): Promise<ZScanResponse>;
     /**
@@ -46212,6 +46470,13 @@ export declare type RedisClient = {
      * @arg {} key
      * @arg {} fieldValues
      * @returns number of fields that were added
+     * @example
+     * ```ts
+     * async function hSetExample(context: Devvit.Context) {
+     *  const numFieldsAdded = await context.redis.hSet("fruits", {"apple": "5", "orange": "7", "kiwi": "9"});
+     *  console.log("Number of fields added: " + numFieldsAdded);
+     * }
+     * ```
      */
     hSet(key: string, fieldValues: {
         [field: string]: string;
@@ -46231,6 +46496,14 @@ export declare type RedisClient = {
      * @arg {} key
      * @arg {} field
      * @returns value associated with field
+     * @example
+     * ```ts
+     * async function hGetExample(context: Devvit.Context) {
+     *  await context.redis.hSet("fruits", {"apple": "5", "orange": "7", "kiwi": "9"});
+     *  const result : string | undefined = await context.redis.hGet("fruits", "orange");
+     *  console.log("Value of orange: " + result);
+     * }
+     * ```
      */
     hGet(key: string, field: string): Promise<string | undefined>;
     /**
@@ -46246,6 +46519,22 @@ export declare type RedisClient = {
      * https://redis.io/commands/hgetall
      * @arg {} key
      * @returns a map of fields and their values stored in the hash,
+     * @example
+     * ```
+     * async function hGetAllExample(context: Devvit.Context) {
+     *  await context.redis.hSet("groceryList", {
+     *   "eggs": "12",
+     *   "apples": "3",
+     *   "milk": "1"
+     *  });
+     *
+     *  const record : Record<string, string> | undefined = await context.redis.hGetAll("groceryList");
+     *
+     *  if (record != undefined) {
+     *   console.log("Eggs: " + record.eggs + ", Apples: " + record.apples + ", Milk: " + record.milk);
+     *  }
+     * }
+     * ```
      */
     hGetAll(key: string): Promise<Record<string, string> | undefined>;
     /**
@@ -46263,6 +46552,14 @@ export declare type RedisClient = {
      * @arg {} key
      * @arg {} fields
      * @returns number of fields that were removed from the hash
+     * @example
+     * ```ts
+     * async function hDelExample(context: Devvit.Context) {
+     *  await context.redis.hSet("fruits", {"apple": "5", "orange": "7", "kiwi": "9"});
+     *  const numFieldsRemoved = await context.redis.hDel("fruits", ["apple", "kiwi"]);
+     *  console.log("Number of fields removed: " + numFieldsRemoved);
+     * }
+     * ```
      */
     hDel(key: string, fields: string[]): Promise<number>;
     /**
@@ -46280,6 +46577,22 @@ export declare type RedisClient = {
      * @arg {} cursor
      * @arg {} pattern
      * @arg {} count
+     * @example
+     * ```ts
+     * async function hScanExample(context: Devvit.Context) {
+     *  await context.redis.hSet("userInfo", {
+     *    "name": "Bob",
+     *    "startDate": "01-05-20",
+     *    "totalAwards": "12"
+     *  });
+     *
+     *  const hScanResponse = await context.redis.hScan("userInfo", 0);
+     *
+     *  hScanResponse.fieldValues.forEach(x => {
+     *    console.log("Field: '" + x.field + "', Value: '" + x.value + "'");
+     *  });
+     * }
+     * ```
      */
     hScan(key: string, cursor: number, pattern?: string | undefined, count?: number | undefined): Promise<HScanResponse>;
     /**
@@ -46291,6 +46604,18 @@ export declare type RedisClient = {
     /**
      * Returns all field names in the hash stored at key.
      * @arg {} key
+     * @example
+     * ```ts
+     * async function hKeysExample(context: Devvit.Context) {
+     *  await context.redis.hSet("prices", {
+     *    "chair": "48",
+     *    "desk": "95",
+     *    "whiteboard": "23"
+     *  });
+     *  const keys : string[] = await context.redis.hKeys("prices");
+     *  console.log("Keys: " + keys);
+     * }
+     * ```
      */
     hKeys(key: string): Promise<string[]>;
     /**
@@ -46310,6 +46635,13 @@ export declare type RedisClient = {
      * @arg {} field
      * @arg {} value
      * @returns value of key after the increment
+     * @example
+     * ```ts
+     * async function hIncrByExample(context: Devvit.Context) {
+     *  await context.redis.hSet("user123", { "karma": "100" });
+     *  await context.redis.hIncrBy("user123", "karma", 5);
+     * }
+     * ```
      */
     hIncrBy(key: string, field: string, value: number): Promise<number>;
     /**
@@ -46323,6 +46655,19 @@ export declare type RedisClient = {
      * Returns the number of fields contained in the hash stored at key.
      * @arg {} key
      * @returns the number of fields in the hash, or 0 when the key does not exist.
+     * @example
+     * ```ts
+     * async function hLenExample(context: Devvit.Context) {
+     *  await context.redis.hSet("supplies", {
+     *    "paperclips": "25",
+     *    "pencils": "10",
+     *    "erasers": "5",
+     *    "pens": "7"
+     *  });
+     *  const numberOfFields : number = await context.redis.hLen("supplies");
+     *  console.log("Number of fields: " + numberOfFields);
+     * }
+     * ```
      */
     hLen(key: string): Promise<number>;
     /**
@@ -66188,24 +66533,96 @@ export declare type TxClientLike = {
      * Executes all previously queued commands in a transaction and
      * restores the connection state to normal. https://redis.io/commands/exec/
      * @returns array, each element being the reply to each of the commands in the atomic transaction.
+     * @example
+     * ```ts
+     * async function execExample(context: Devvit.Context) {
+     *  await context.redis.set("karma", "32");
+     *
+     *  const txn = await context.redis.watch("quantity");
+     *
+     *  await txn.multi();  // Begin a transaction
+     *  await txn.incrBy("karma", 10);
+     *  await txn.exec();   // Execute the commands in the transaction
+     * }
+     * ```
      */
     exec(): Promise<any[]>;
     /**
      * Marks the start of a transaction block. Subsequent commands will be
      * queued for atomic execution using EXEC. https://redis.io/commands/multi/
+     * @example
+     * ```ts
+     * async function multiExample(context: Devvit.Context) {
+     *  await context.redis.set("karma", "32");
+     *
+     *  const txn = await context.redis.watch("quantity");
+     *
+     *  await txn.multi();  // Begin a transaction
+     *  await txn.incrBy("karma", 10);
+     *  await txn.exec();   // Execute the commands in the transaction
+     * }
+     * ```
      */
     multi(): Promise<void>;
+    /**
+     * Flushes all previously queued commands in a transaction and restores the connection state to normal.
+     * If WATCH was used, DISCARD unwatches all keys watched by the connection. https://redis.io/docs/latest/commands/discard/
+     * @example
+     * ```ts
+     * async function discardExample(context: Devvit.Context) {
+     *  await context.redis.set("price", "25");
+     *
+     *  const txn = await context.redis.watch("price");
+     *
+     *  await txn.multi();     // Begin a transaction
+     *  await txn.incrBy("price", 5);
+     *  await txn.discard();   // Discard the commands in the transaction
+     * }
+     * ```
+     */
     discard(): Promise<void>;
     /**
      * Marks the given keys to be watched for conditional execution of a transaction.
      * https://redis.io/commands/watch/
      * @arg {} keys - given keys to be watched
+     * @example
+     * ```ts
+     * async function watchExample(context: Devvit.Context) {
+     *  await context.redis.set("karma", "32");
+     *
+     *  const txn = await context.redis.watch("quantity");
+     *
+     *  await txn.multi();  // Begin a transaction
+     *  await txn.incrBy("karma", 10);
+     *  await txn.exec();   // Execute the commands in the transaction
+     * }
+     * ```
      */
     watch(...keys: string[]): Promise<TxClientLike>;
     /**
      * Flushes all the previously watched keys for a transaction.
      * If you call EXEC or DISCARD, there's no need to manually call UNWATCH.
      * https://redis.io/commands/unwatch/
+     * @example
+     * ```ts
+     * async function unwatchExample(context: Devvit.Context) {
+     *  await context.redis.set("gold", "50");
+     *
+     *  const txn = await context.redis.watch("gold");
+     *
+     *  await txn.multi();     // Begin a transaction
+     *  await txn.incrBy("gold", 30);
+     *  await txn.unwatch();   // Unwatch "gold"
+     *
+     *  // Now that "gold" has been unwatched, we can increment its value
+     *  // outside the transaction without canceling the transaction
+     *  await context.redis.incrBy("gold", -20);
+     *
+     *  await txn.exec();   // Execute the commands in the transaction
+     *
+     *  console.log("Gold value: " + await context.redis.get("gold")); // The value of 'gold' should be 50 + 30 - 20 = 60
+     * }
+     * ```
      */
     unwatch(): Promise<TxClientLike>;
     /**
@@ -66213,6 +66630,14 @@ export declare type TxClientLike = {
      * https://redis.io/commands/get/
      * @arg {} key
      * @returns value of key or null when key does not exist.
+     * @example
+     * ```ts
+     * async function getExample(context: Devvit.Context) {
+     *  await context.redis.set("quantity", "5");
+     *  const quantity : string | undefined = await context.redis.get("quantity");
+     *  console.log("Quantity: " + quantity);
+     * }
+     * ```
      */
     get(key: string): Promise<TxClientLike>;
     /**
@@ -66221,12 +66646,25 @@ export declare type TxClientLike = {
      * @arg {} key
      * @arg {} value
      * @arg {} options
+     * @example
+     * ```ts
+     * async function setExample(context: Devvit.Context) {
+     *  await context.redis.set("quantity", "5");
+     * }
+     * ```
      */
     set(key: string, value: string, options?: SetOptions): Promise<TxClientLike>;
     /**
      * Removes the specified keys. A key is ignored if it does not exist.
      * https://redis.io/commands/del/
      * @arg {} keys
+     * @example
+     * ```ts
+     * async function delExample(context: Devvit.Context) {
+     *  await context.redis.set("quantity", "5");
+     *  await context.redis.del("quantity");
+     * }
+     * ```
      */
     del(...keys: string[]): Promise<TxClientLike>;
     /**
@@ -66234,6 +66672,14 @@ export declare type TxClientLike = {
      * https://redis.io/commands/incrby/
      * @arg {} key
      * @arg {} value
+     * @example
+     * ```ts
+     * async function incrByExample(context: Devvit.Context) {
+     *  await context.redis.set("totalPoints", "53")
+     *  const updatedPoints : number = await context.redis.incrBy("totalPoints", 100);
+     *  console.log("Updated points: " + updatedPoints);
+     * }
+     * ```
      */
     incrBy(key: string, value: number): Promise<TxClientLike>;
     /**
@@ -66241,6 +66687,14 @@ export declare type TxClientLike = {
      * https://redis.io/commands/type/
      * @arg {} key
      * @returns string representation of the type
+     * @example
+     * ```ts
+     * async function typeExample(context: Devvit.Context) {
+     *  await context.redis.set("quantity", "5");
+     *  const type : string = await context.redis.type("quantity");
+     *  console.log("Key type: " + type);
+     * }
+     * ```
      */
     type(key: string): Promise<TxClientLike>;
     /**
@@ -66251,6 +66705,14 @@ export declare type TxClientLike = {
      * @arg {} start
      * @arg {} end
      * @returns substring determined by offsets [start, end]
+     * @example
+     * ```ts
+     * async function getRangeExample(context: Devvit.Context) {
+     *  await context.redis.set("word", "tacocat");
+     *  const range : string = await context.redis.getRange("word", 0, 3)
+     *  console.log("Range from index 0 to 3: " + range);
+     * }
+     * ```
      */
     getRange(key: string, start: number, end: number): Promise<TxClientLike>;
     /**
@@ -66260,6 +66722,13 @@ export declare type TxClientLike = {
      * @arg {} key
      * @arg {} offset
      * @returns length of the string after it was modified by the command
+     * @example
+     * ```ts
+     * async function setRangeExample(context: Devvit.Context) {
+     *  await context.redis.set("word", "tacocat");
+     *  await context.redis.setRange("word", 0, "blue");
+     * }
+     * ```
      */
     setRange(key: string, offset: number, value: string): Promise<TxClientLike>;
     /**
@@ -66277,6 +66746,14 @@ export declare type TxClientLike = {
      * https://redis.io/commands/strlen/
      * @arg {} key
      * @returns length of the string stored at key
+     * @example
+     * ```ts
+     * async function strLenExample(context: Devvit.Context) {
+     *  await context.redis.set("word", "tacocat");
+     *  const length : number = await context.redis.strLen("word");
+     *  console.log("Length of word: " + length);
+     * }
+     * ```
      */
     strLen(key: string): Promise<TxClientLike>;
     /**
@@ -66292,6 +66769,16 @@ export declare type TxClientLike = {
      * https://redis.io/commands/mget/
      * @arg {} keys
      * @returns list of values at the specified keys
+     * @example
+     * ```ts
+     * async function mGetExample(context: Devvit.Context) {
+     *  await context.redis.mSet({"name": "Zeek", "occupation": "Developer"});
+     *  const result : (string | null)[] = await context.redis.mGet(["name", "occupation"]);
+     *  result.forEach(x => {
+     *    console.log(x);
+     *  });
+     * }
+     * ```
      */
     mGet(keys: string[]): Promise<TxClientLike>;
     /**
@@ -66307,6 +66794,12 @@ export declare type TxClientLike = {
      * Sets the given keys to their respective values.
      * https://redis.io/commands/mset/
      * @arg {} keyValues
+     * @example
+     * ```ts
+     * async function mSetExample(context: Devvit.Context) {
+     *  await context.redis.mSet({"name": "Zeek", "occupation": "Developer"});
+     * }
+     * ```
      */
     mSet(keyValues: {
         [key: string]: string;
@@ -66316,6 +66809,13 @@ export declare type TxClientLike = {
      * https://redis.io/commands/expire/
      * @arg {} key
      * @arg {} seconds
+     * @example
+     * ```ts
+     * async function expireExample(context: Devvit.Context) {
+     *  await context.redis.set("product", "milk");
+     *  await context.redis.expire("product", 60);   // Set the product to expire in 60 seconds
+     * }
+     * ```
      */
     expire(key: string, seconds: number): Promise<TxClientLike>;
     /**
@@ -66323,6 +66823,12 @@ export declare type TxClientLike = {
      * https://redis.io/commands/expiretime/
      * @arg {} key
      * @returns expiration Unix timestamp in seconds, or a negative value in order to signal an error
+     * @example
+     * async function expireTimeExample(context: Devvit.Context) {
+     *  await context.redis.set("product", "milk");
+     *  const expireTime : number = await context.redis.expireTime("product");
+     *  console.log("Expire time: " + expireTime);
+     * }
      */
     expireTime(key: string): Promise<TxClientLike>;
     /**
@@ -66330,6 +66836,18 @@ export declare type TxClientLike = {
      * https://redis.io/commands/zadd/
      * @arg {} key
      * @returns number of elements added to the sorted set
+     * @example
+     * ```ts
+     * async function zAddExample(context: Devvit.Context) {
+     *  const numMembersAdded : number = await context.redis.zAdd("leaderboard",
+     *    {member: "louis", score: 37},
+     *    {member: "fernando", score: 10},
+     *    {member: "caesar", score: 20},
+     *    {member: "alexander", score: 25},
+     *  );
+     *  console.log("Number of members added: " + numMembersAdded);
+     * }
+     * ```
      */
     zAdd(key: string, ...members: ZMember[]): Promise<TxClientLike>;
     /**
@@ -66337,6 +66855,19 @@ export declare type TxClientLike = {
      * https://redis.io/commands/zcard/
      * @arg {} key
      * @returns cardinality of the sorted set
+     * @example
+     * ```ts
+     * async function zCardExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("leaderboard",
+     *    {member: "louis", score: 37},
+     *    {member: "fernando", score: 10},
+     *    {member: "caesar", score: 20},
+     *    {member: "alexander", score: 25},
+     *  );
+     *  const cardinality : number = await context.redis.zCard("leaderboard");
+     *  console.log("Cardinality: " + cardinality);
+     * }
+     * ```
      */
     zCard(key: string): Promise<TxClientLike>;
     /**
@@ -66346,6 +66877,19 @@ export declare type TxClientLike = {
      * @arg {} member
      * @arg {} value
      * @returns the new score of member as a double precision floating point number
+     * @example
+     * ```ts
+     * async function zIncrByExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("animals",
+     *    {member: "zebra", score: 92},
+     *    {member: "cat", score: 100},
+     *    {member: "dog", score: 95},
+     *    {member: "elephant", score: 97}
+     *  );
+     *  const updatedScore : number = await context.redis.zIncrBy("animals", "dog", 10);
+     *  console.log("Dog's updated score: " + updatedScore);
+     * }
+     * ```
      */
     zIncrBy(key: string, member: string, value: number): Promise<TxClientLike>;
     /**
@@ -66355,6 +66899,19 @@ export declare type TxClientLike = {
      * @arg {} member
      * @returns rank of the member. The rank (or index) is 0-based
      * which means that the member with the lowest score has rank 0
+     * @example
+     * ```ts
+     * async function zRankExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("animals",
+     *    {member: "zebra", score: 92},
+     *    {member: "cat", score: 100},
+     *    {member: "dog", score: 95},
+     *    {member: "elephant", score: 97}
+     *  );
+     *  const rank : number = await context.redis.zRank("animals", "dog");
+     *  console.log("Dog's rank: " + rank);
+     * }
+     * ```
      */
     zRank(key: string, member: string): Promise<TxClientLike>;
     /**
@@ -66363,6 +66920,19 @@ export declare type TxClientLike = {
      * @arg {} key
      * @arg {} member
      * @returns the score of the member (a double-precision floating point number).
+     * @example
+     * ```ts
+     * async function zScoreExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("leaderboard",
+     *    {member: "louis", score: 37},
+     *    {member: "fernando", score: 10},
+     *    {member: "caesar", score: 20},
+     *    {member: "alexander", score: 25},
+     *  );
+     *  const score : number = await context.redis.zScore("leaderboard", "caesar");
+     *  console.log("Caesar's score: " + score);
+     * }
+     * ```
      */
     zScore(key: string, member: string): Promise<TxClientLike>;
     /**
@@ -66371,6 +66941,20 @@ export declare type TxClientLike = {
      * @arg {} cursor
      * @arg {} pattern
      * @arg {} count
+     * @example
+     * ```ts
+     * async function zScanExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("fruits",
+     *    {member: "kiwi", score: 0},
+     *    {member: "mango", score: 0},
+     *    {member: "banana", score: 0},
+     *    {member: "orange", score: 0},
+     *    {member: "apple", score: 0},
+     *  );
+     *  const zScanResponse = await context.redis.zScan("fruits", 0);
+     *  console.log("zScanResponse: " + JSON.stringify(zScanResponse));
+     * }
+     * ```
      */
     zScan(key: string, cursor: number, pattern?: string | undefined, count?: number | undefined): Promise<TxClientLike>;
     /**
@@ -66381,6 +66965,24 @@ export declare type TxClientLike = {
      * @arg {} stop
      * @arg {} options
      * @returns list of elements in the specified range
+     * @example
+     * ```ts
+     * async function zRangeExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("leaderboard",
+     *    {member: "louis", score: 37},
+     *    {member: "fernando", score: 10},
+     *    {member: "caesar", score: 20},
+     *    {member: "alexander", score: 25},
+     *  );
+     *
+     *  // View elements with scores between 0 and 30 inclusive, sorted by score
+     *  const scores : {member : string, score : number}[] = await context.redis.zRange("leaderboard", 0, 30, { by: "score" });
+     *
+     *  scores.forEach(x => {
+     *    console.log("Member: " + x.member, ", Score: " + x.score);
+     *  });
+     * }
+     * ```
      */
     zRange(key: string, start: number | string, stop: number | string, options?: ZRangeOptions): Promise<TxClientLike>;
     /**
@@ -66389,6 +66991,19 @@ export declare type TxClientLike = {
      * @arg {} key
      * @arg {} members
      * @returns number of members removed from the sorted set
+     * @example
+     * ```ts
+     * async function zRemExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("leaderboard",
+     *    {member: "louis", score: 37},
+     *    {member: "fernando", score: 10},
+     *    {member: "caesar", score: 20},
+     *    {member: "alexander", score: 25},
+     *  );
+     *  const numberOfMembersRemoved : number = await context.redis.zRem("leaderboard", ["fernando", "alexander"]);
+     *  console.log("Number of members removed: " + numberOfMembersRemoved);
+     * }
+     * ```
      */
     zRem(key: string, members: string[]): Promise<TxClientLike>;
     /**
@@ -66399,6 +67014,23 @@ export declare type TxClientLike = {
      * @arg {} min
      * @arg {} max
      * @returns number of members removed from the sorted set
+     * @example
+     * ```ts
+     * async function zRemRangeByLexExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("fruits",
+     *    {member: "kiwi", score: 0},
+     *    {member: "mango", score: 0},
+     *    {member: "banana", score: 0},
+     *    {member: "orange", score: 0},
+     *    {member: "apple", score: 0},
+     *  );
+     *
+     *  // Remove fruits alphabetically ordered between 'kiwi' inclusive and 'orange' exclusive
+     *  // Note: The symbols '[' and '(' indicate inclusive or exclusive, respectively. These must be included in the call to zRemRangeByLex().
+     *  const numFieldsRemoved : number = await context.redis.zRemRangeByLex("fruits", "[kiwi", "(orange");
+     *  console.log("Number of fields removed: " + numFieldsRemoved);
+     * }
+     * ```
      */
     zRemRangeByLex(key: string, min: string, max: string): Promise<TxClientLike>;
     /**
@@ -66408,6 +67040,22 @@ export declare type TxClientLike = {
      * @arg {} start
      * @arg {} stop
      * @returns number of members removed from the sorted set
+     * @example
+     * ```
+     * async function zRemRangeByRankExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("fruits",
+     *    {member: "kiwi", score: 10},
+     *    {member: "mango", score: 20},
+     *    {member: "banana", score: 30},
+     *    {member: "orange", score: 40},
+     *    {member: "apple", score: 50},
+     *  );
+
+     *  // Remove fruits ranked 1 through 3 inclusive
+     *  const numFieldsRemoved : number = await context.redis.zRemRangeByRank("fruits", 1, 3);
+     *  console.log("Number of fields removed: " + numFieldsRemoved);
+     * }
+     * ```
      */
     zRemRangeByRank(key: string, start: number, stop: number): Promise<TxClientLike>;
     /**
@@ -66417,6 +67065,21 @@ export declare type TxClientLike = {
      * @arg {} min
      * @arg {} max
      * @returns number of members removed from the sorted set
+     * @example
+     * ```ts
+     * async function zRemRangeByScoreExample(context: Devvit.Context) {
+     *  await context.redis.zAdd("fruits",
+     *    {member: "kiwi", score: 10},
+     *    {member: "mango", score: 20},
+     *    {member: "banana", score: 30},
+     *    {member: "orange", score: 40},
+     *    {member: "apple", score: 50},
+     *  );
+     *  // Remove fruits scored between 30 and 50 inclusive
+     *  const numFieldsRemoved : number = await context.redis.zRemRangeByScore("fruits", 30, 50);
+     *  console.log("Number of fields removed: " + numFieldsRemoved);
+     * }
+     * ```
      */
     zRemRangeByScore(key: string, min: number, max: number): Promise<TxClientLike>;
     /**
@@ -66436,6 +67099,13 @@ export declare type TxClientLike = {
      * @arg {} key
      * @arg {} fieldValues
      * @returns number of fields that were added
+     * @example
+     * ```ts
+     * async function hSetExample(context: Devvit.Context) {
+     *  const numFieldsAdded = await context.redis.hSet("fruits", {"apple": "5", "orange": "7", "kiwi": "9"});
+     *  console.log("Number of fields added: " + numFieldsAdded);
+     * }
+     * ```
      */
     hSet(key: string, fieldValues: {
         [field: string]: string;
@@ -66455,6 +67125,14 @@ export declare type TxClientLike = {
      * @arg {} key
      * @arg {} field
      * @returns value associated with field
+     * @example
+     * ```ts
+     * async function hGetExample(context: Devvit.Context) {
+     *  await context.redis.hSet("fruits", {"apple": "5", "orange": "7", "kiwi": "9"});
+     *  const result : string | undefined = await context.redis.hGet("fruits", "orange");
+     *  console.log("Value of orange: " + result);
+     * }
+     * ```
      */
     hGet(key: string, field: string): Promise<TxClientLike>;
     /**
@@ -66470,6 +67148,22 @@ export declare type TxClientLike = {
      * https://redis.io/commands/hgetall
      * @arg {} key
      * @returns a map of fields and their values stored in the hash,
+     * @example
+     * ```
+     * async function hGetAllExample(context: Devvit.Context) {
+     *  await context.redis.hSet("groceryList", {
+     *   "eggs": "12",
+     *   "apples": "3",
+     *   "milk": "1"
+     *  });
+     *
+     *  const record : Record<string, string> | undefined = await context.redis.hGetAll("groceryList");
+     *
+     *  if (record != undefined) {
+     *   console.log("Eggs: " + record.eggs + ", Apples: " + record.apples + ", Milk: " + record.milk);
+     *  }
+     * }
+     * ```
      */
     hGetAll(key: string): Promise<TxClientLike>;
     /**
@@ -66487,6 +67181,14 @@ export declare type TxClientLike = {
      * @arg {} key
      * @arg {} fields
      * @returns number of fields that were removed from the hash
+     * @example
+     * ```ts
+     * async function hDelExample(context: Devvit.Context) {
+     *  await context.redis.hSet("fruits", {"apple": "5", "orange": "7", "kiwi": "9"});
+     *  const numFieldsRemoved = await context.redis.hDel("fruits", ["apple", "kiwi"]);
+     *  console.log("Number of fields removed: " + numFieldsRemoved);
+     * }
+     * ```
      */
     hDel(key: string, fields: string[]): Promise<TxClientLike>;
     /**
@@ -66504,6 +67206,22 @@ export declare type TxClientLike = {
      * @arg {} cursor
      * @arg {} pattern
      * @arg {} count
+     * @example
+     * ```ts
+     * async function hScanExample(context: Devvit.Context) {
+     *  await context.redis.hSet("userInfo", {
+     *    "name": "Bob",
+     *    "startDate": "01-05-20",
+     *    "totalAwards": "12"
+     *  });
+     *
+     *  const hScanResponse = await context.redis.hScan("userInfo", 0);
+     *
+     *  hScanResponse.fieldValues.forEach(x => {
+     *    console.log("Field: '" + x.field + "', Value: '" + x.value + "'");
+     *  });
+     * }
+     * ```
      */
     hScan(key: string, cursor: number, pattern?: string | undefined, count?: number | undefined): Promise<TxClientLike>;
     /**
@@ -66515,6 +67233,18 @@ export declare type TxClientLike = {
     /**
      * Returns all field names in the hash stored at key.
      * @arg {} key
+     * @example
+     * ```ts
+     * async function hKeysExample(context: Devvit.Context) {
+     *  await context.redis.hSet("prices", {
+     *    "chair": "48",
+     *    "desk": "95",
+     *    "whiteboard": "23"
+     *  });
+     *  const keys : string[] = await context.redis.hKeys("prices");
+     *  console.log("Keys: " + keys);
+     * }
+     * ```
      */
     hKeys(key: string): Promise<TxClientLike>;
     /**
@@ -66534,6 +67264,13 @@ export declare type TxClientLike = {
      * @arg {} field
      * @arg {} value
      * @returns value of key after the increment
+     * @example
+     * ```ts
+     * async function hIncrByExample(context: Devvit.Context) {
+     *  await context.redis.hSet("user123", { "karma": "100" });
+     *  await context.redis.hIncrBy("user123", "karma", 5);
+     * }
+     * ```
      */
     hIncrBy(key: string, field: string, value: number): Promise<TxClientLike>;
     /**
@@ -66547,6 +67284,19 @@ export declare type TxClientLike = {
      * Returns the number of fields contained in the hash stored at key.
      * @arg {} key
      * @returns the number of fields in the hash, or 0 when the key does not exist.
+     * @example
+     * ```ts
+     * async function hLenExample(context: Devvit.Context) {
+     *  await context.redis.hSet("supplies", {
+     *    "paperclips": "25",
+     *    "pencils": "10",
+     *    "erasers": "5",
+     *    "pens": "7"
+     *  });
+     *  const numberOfFields : number = await context.redis.hLen("supplies");
+     *  console.log("Number of fields: " + numberOfFields);
+     * }
+     * ```
      */
     hLen(key: string): Promise<TxClientLike>;
 };