feat(redis): support database aliases

This commit is contained in:
lewis authored and GitHub committed 2026-07-29 20:33:34 +08:00
1 parent 5309170bf7
commit 4a6422365b
39 files changed
+443 -9

No files matched your search

@@ -0,0 +1,35 @@
import { describe, expect, it } from "vitest";
import { normalizeRedisDatabaseAliases, redisDatabaseAlias, redisDatabaseLabel } from "@/lib/redis/redisDatabaseAlias";
describe("redisDatabaseAlias", () => {
it("normalizes numeric database keys and trims aliases", () => {
expect(
normalizeRedisDatabaseAliases({
"0": " default ",
"03": " orders ",
invalid: "ignored",
"4": "",
}),
).toEqual({
"0": "default",
"3": "orders",
});
});
it("returns undefined for empty alias maps", () => {
expect(normalizeRedisDatabaseAliases({ "0": " " })).toBeUndefined();
expect(normalizeRedisDatabaseAliases(null)).toBeUndefined();
});
it("looks up aliases without changing the Redis database index", () => {
const aliases = { "3": "orders" };
expect(redisDatabaseAlias(aliases, "03")).toBe("orders");
expect(redisDatabaseAlias(aliases, "invalid")).toBeUndefined();
});
it("formats labels with aliases and key counts", () => {
expect(redisDatabaseLabel(3, { "3": "orders" }, 128)).toBe("db3 · orders (128)");
expect(redisDatabaseLabel(0, undefined, 0)).toBe("db0 (0)");
expect(redisDatabaseLabel(2, { "2": "cache" })).toBe("db2 · cache");
});
});
@@ -0,0 +1,30 @@
export type RedisDatabaseAliases = Record<string, string>;
function redisDatabaseKey(database: string | number): string | null {
const index = typeof database === "number" ? database : Number(database);
return Number.isInteger(index) && index >= 0 ? String(index) : null;
}
export function normalizeRedisDatabaseAliases(value: unknown): RedisDatabaseAliases | undefined {
if (!value || typeof value !== "object" || Array.isArray(value)) return undefined;
const aliases: RedisDatabaseAliases = {};
for (const [database, alias] of Object.entries(value)) {
const key = redisDatabaseKey(database);
const normalizedAlias = typeof alias === "string" ? alias.trim() : "";
if (key != null && normalizedAlias) aliases[key] = normalizedAlias;
}
return Object.keys(aliases).length > 0 ? aliases : undefined;
}
export function redisDatabaseAlias(aliases: RedisDatabaseAliases | undefined, database: string | number): string | undefined {
const key = redisDatabaseKey(database);
return key == null ? undefined : aliases?.[key]?.trim() || undefined;
}
export function redisDatabaseLabel(database: string | number, aliases?: RedisDatabaseAliases, totalKeyCount?: number): string {
const key = redisDatabaseKey(database) ?? String(database);
const alias = redisDatabaseAlias(aliases, key);
const name = alias ? `db${key} · ${alias}` : `db${key}`;
return totalKeyCount == null ? name : `${name} (${totalKeyCount})`;
}