All skills
upstash avatar

/upstash-redis-js

@35da719
by upstashupstash/skills27 stars
7

Work with the @upstash/redis TypeScript/JavaScript SDK, a serverless HTTP-based Redis client for Next.js, Vercel, Cloudflare Workers, edge runtimes, and Node.js. Use when adding a cache (cache-aside, write-through, TTL and expiration strategies), session storage and user sessions, a key-value store, leaderboards and rankings with sorted sets, counters, distributed locks, queues with lists, streams and consumer groups, sparse index-addressed arrays and ring buffers (ARSET, ARINSERT, ARRING, ARGREP, AROP), embeddings and nearest-neighbour vector search stored inside Redis (VECTOR commands via redis.vector, separate from @upstash/vector), JSON documents, pipelines and MULTI/EXEC transactions, Lua scripting, read replicas, or full-text search, typo-tolerant search, facets, aggregations, and search over Redis stream entries with Upstash Redis Search (different from regular FT.SEARCH; also available for TCP clients via @upstash/search-redis and @upstash/search-ioredis). Also use when migrating from ioredis or node-redis, when a Redis connection is needed from a serverless function without connection pooling, when integrating @upstash/ratelimit, or when the user says Redis cache, KV store, session store, serverless Redis, or Upstash Redis. Supports automatic serialization/deserialization of JavaScript types.

Use this Skill: https://skilld.dev/gh/upstash/skills/upstash-redis-js

This session only. Nothing lands on disk.

performancebatching-operations.md

≈514 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Batching Operations

Overview

Batch multiple Redis operations into single commands to reduce network round trips. Use MGET/MSET for strings, HMGET/HMSET for hashes, pipelines for mixed operations.

Good For

  • Fetching multiple keys at once
  • Bulk data loading
  • Reducing latency in high-latency networks
  • Operations on related data

Limitations

  • Batch operations are atomic per command, not across commands
  • Some commands don't have batch equivalents

Examples

import { Redis } from "@upstash/redis";

const redis = Redis.fromEnv();

// MGET - batch get multiple keys
const [user1, user2, user3] = await redis.mget<any[]>("user:1", "user:2", "user:3");

// MSET - batch set multiple keys
await redis.mset({
  "user:1": { name: "Alice", age: 30 },
  "user:2": { name: "Bob", age: 25 },
  "user:3": { name: "Charlie", age: 35 },
});

// Compare: individual operations (3 round trips)
const u1 = await redis.get("user:1");
const u2 = await redis.get("user:2");
const u3 = await redis.get("user:3");

// vs batch operation (1 round trip)
const users = await redis.mget("user:1", "user:2", "user:3");

// HMGET - batch get hash fields
const [name, email] = await redis.hmget("user:123", "name", "email");

// HMSET - batch set hash fields
await redis.hset("user:123", {
  name: "Alice",
  email: "alice@example.com",
  age: 30,
});

// Batch with mixed operations - use pipeline
const pipeline = redis.pipeline();
userIds.forEach((id) => {
  pipeline.get(`user:${id}`);
  pipeline.hgetall(`user:${id}:profile`);
  pipeline.zrank("leaderboard", id);
});
const results = await pipeline.exec();

// Batch delete
await redis.del("key1", "key2", "key3", "key4");

// Batch SADD
await redis.sadd("tags", "redis", "nodejs", "typescript", "upstash");

// Batch with Promise.all (for independent operations)
const [userCount, postCount, commentCount] = await Promise.all([
  redis.get("count:users"),
  redis.get("count:posts"),
  redis.get("count:comments"),
]);
// Note: With auto-pipelining enabled, these batch automatically

Source: SKILL.md on GitHub

1 warningtoday3 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    The skill provides a comprehensive guide for using the Upstash Redis JavaScript SDK. It follows security best practices for credential management by advocating for environment variables and relies on official vendor resources. While the skill facilitates data ingestion from external databases, it does so as a standard database client with no malicious patterns or unexpected behaviors detected.

  • Sockettoday

    1 alert: gptSecurity

  • Snyktoday

    Risk: LOW · No issues

Signed by skilld at 35da719. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 5 days ago.

Activeupdated 2 weeks ago
metadata
{
  "author": "Upstash",
  "homepage": "https://upstash.com"
}

README badge

README badge for upstash/skills/upstash-redis-js