Upstash RedisSDKv1.0.0の発表

本日、@upstash/redisを発表します v1.0.0。

@upstash/redis サーバーレス向けに設計され、Cloudflareワーカーと高速に互換性のある唯一のコネクションレス（HTTPベース）Redisクライアントです。

v1.0.0の新機能

バージョン1.0.0は、以前のライブラリを完全に書き直したものです。私たちが受け取った最大の機能リクエストの中には、パイプラインのサポートとタイプセーフティの改善がありました。これらの新機能の性質により、v1 下位互換性はありませんが、基盤となるREST APIが変更されていないため、古いバージョンは引き続き機能します。

ほとんどのコマンドは、redis.setex("key", 2, "value")のようにRedisで使用されているのと同じ構文に従います。 。 hsetなどの他の場合 自分で行う必要のある（逆）シリアル化の量を減らすために、より使いやすいAPIを提供しています：

await redis.hset("123", {
  id: "123",
  name: { first: "andreas" },
});

これは内部でhset 123 id 123 name {"first":"andreas"}にシリアル化されます そしてUpstashに送られました。オブジェクトは自動的にシリアル化されるため、自分でシリアル化する必要はありません。

コマンドの使用方法がわからない場合は、エディターがインテリセンスをサポートしていれば、typescriptが役立ちます。また、すべてを網羅し、例として役立つ可能性のあるテストも確認してください。

最も重要な変更点は次のとおりです：

• 明示的な認証
• さまざまなプラットフォーム（Node.js、Cloudflareワーカー、高速）向けに最適化
• 改良された型システム
• エラーがスローされます
• パイプラインのサポート

import { Redis } from "@upstash/redis";
const redis = Redis.fromEnv();

import { Redis } from "@upstash/redis/cloudflare";
const redis = Redis.fromEnv();

import { Redis } from "@upstash/redis";
const redis = new Redis({
  /* auth */
});

type User = {
  id: string;
  email: string;
};

const user = {
  id: "abc",
  email: "[email protected]",
};

await redis.set<User>("userKey", user);

const user = await redis.get<User>("userKey");
// -> user is typed as User

redis.set("key", "value", {
  ex: 60, // expire in 60 seconds
  nx: true, // only create if the key does not yet exist
});

// `v0.2.1`
const { data, error } = await set("key", "value");
if (error) {
  throw new Error(error);
}

// '^v1.0.0'
const data = await redis.set("key", "value");

import { Redis } from "@upstash/redis";
const redis = new Redis({
  /* auth */
});

const p = redis.pipeline();

p.set("key", 2);

// or chain directly
p.incr("key").decrby("key", 2);

const res = await p.exec();
// res[0] => "OK"   | the result of p.set("key", 2)
// res[1] => 3      | the result of p.incr("key")
// res[2] => 1      | the result of p.decrby("key", 2)