Skip to content

armgit / dbx

Public Imported from GitHub
0

25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 100+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP。

feat(redis): copy executable Redis commands instead of descriptions in danger dialogs (#12892)

lxk955997b7998df6e
diff --git a/apps/desktop/src/components/redis/RedisKeyBrowser.expiry.spec.ts b/apps/desktop/src/components/redis/RedisKeyBrowser.expiry.spec.ts
index 88a16b37fd..3510bd04e3 100644
--- a/apps/desktop/src/components/redis/RedisKeyBrowser.expiry.spec.ts
+++ b/apps/desktop/src/components/redis/RedisKeyBrowser.expiry.spec.ts
@@ -292,13 +292,14 @@ vi.mock("@/components/editor/DangerConfirmDialog.vue", async () => {
const { defineComponent, h } = await import("vue");
return {
default: defineComponent({
- props: { open: Boolean, loading: Boolean, details: String },
+ props: { open: Boolean, loading: Boolean, details: String, detailsText: String, sql: String },
emits: ["confirm"],
setup(props, { emit }) {
return () =>
props.open
? h("div", { "data-test-danger-dialog": "" }, [
- h("div", { "data-test-danger-details": "" }, props.details),
+ h("div", { "data-test-danger-details": "" }, props.detailsText ?? props.details),
+ h("div", { "data-test-danger-sql": "" }, props.sql),
h(
"button",
{
@@ -1600,6 +1601,7 @@ describe("RedisKeyBrowser fuzzy key hierarchy", () => {
expect(mocks.redisDeleteKeys).not.toHaveBeenCalled();
expect(requiredElement<HTMLElement>("[data-test-danger-details]").textContent).toContain("session:current");
+ expect(requiredElement<HTMLElement>("[data-test-danger-sql]").textContent).toBe("DEL session:current");
requiredElement<HTMLButtonElement>("[data-test-danger-confirm]").click();
await settle();
@@ -1625,6 +1627,8 @@ describe("RedisKeyBrowser fuzzy key hierarchy", () => {
expect(mocks.redisDeleteKeys).not.toHaveBeenCalled();
expect(requiredElement<HTMLElement>("[data-test-danger-details]").textContent).toContain("MCP");
+ expect(requiredElement<HTMLElement>("[data-test-danger-sql]").textContent).toContain("EVAL");
+ expect(requiredElement<HTMLElement>("[data-test-danger-sql]").textContent).toContain("MCP:*");
requiredElement<HTMLButtonElement>("[data-test-danger-confirm]").click();
await settle();
diff --git a/apps/desktop/src/components/redis/RedisKeyBrowser.vue b/apps/desktop/src/components/redis/RedisKeyBrowser.vue
index ea856fdf58..23be8536d7 100644
--- a/apps/desktop/src/components/redis/RedisKeyBrowser.vue
+++ b/apps/desktop/src/components/redis/RedisKeyBrowser.vue
@@ -18,6 +18,7 @@ import { Switch } from "@/components/ui/switch";
import DateTimePicker from "@/components/ui/date-time-picker/DateTimePicker.vue";
import CustomContextMenu, { type ContextMenuItem } from "@/components/ui/CustomContextMenu.vue";
import DangerConfirmDialog from "@/components/editor/DangerConfirmDialog.vue";
+import { redisDeleteGroupPreview, redisDeleteKeysPreview } from "@/lib/redis/redisCommandPreview";
import { redisValuePreviewLimitBytes } from "@/lib/redis/redisValuePreviewLimit";
import RedisValueViewer from "./RedisValueViewer.vue";
import RedisPubSubPanel from "./RedisPubSubPanel.vue";
@@ -51,7 +52,7 @@ import {
} from "@/lib/redis/redisKeyTree";
import { classifyRedisCommandSafety } from "@/lib/redis/redisCommandSafety";
import { isRedisMutatingCommand } from "@/lib/redis/redisCommandTable";
-import { isRedisClearScreenCommand, nextRedisCommandDb, redisKeyTextToRaw } from "@/lib/redis/redisCommandSession";
+import { isRedisClearScreenCommand, nextRedisCommandDb, redisKeyRawToText, redisKeyTextToRaw } from "@/lib/redis/redisCommandSession";
import { buildRedisCompletionItemsFromContext, getRedisCompletionContext, takesKeyArgument, type RedisCompletionItem } from "@/lib/redis/redisCompletion";
import type { RedisCommandDocumentation } from "@/lib/redis/redisCommandDocs";
import { formatRedisConsoleValue, redisValuePreview, redisValueSize } from "@/lib/redis/redisValuePresentation";
@@ -458,7 +459,7 @@ const selectedKey = computed(() => {
void keyMetadataEpoch.value;
return selectedKeyRaw.value ? (flatKeyByRaw.get(selectedKeyRaw.value) ?? null) : null;
});
-const dangerDetails = computed(() => {
+const dangerDetailsText = computed(() => {
if (!pendingDanger.value) return "";
if (pendingDanger.value.kind === "delete-keys") {
return t(pendingDanger.value.loadedSearchResults ? "redis.deleteLoadedSearchKeysDetails" : "redis.deleteGroupDetails", {
@@ -474,6 +475,21 @@ const dangerDetails = computed(() => {
count: pendingDanger.value.loadedCount,
});
}
+ return "";
+});
+function redisKeyNameFromRaw(keyRaw: string): string {
+ return flatKeyByRaw.get(keyRaw)?.key_display ?? redisKeyRawToText(keyRaw) ?? keyRaw;
+}
+
+const dangerSql = computed(() => {
+ if (!pendingDanger.value) return "";
+ if (pendingDanger.value.kind === "delete-keys") {
+ const keyNames = pendingDanger.value.keyRaws.map(redisKeyNameFromRaw);
+ return redisDeleteKeysPreview(keyNames);
+ }
+ if (pendingDanger.value.kind === "delete-group") {
+ return redisDeleteGroupPreview(pendingDanger.value.pattern);
+ }
return pendingDanger.value.command;
});
const dangerConfirmLabel = computed(() => {
@@ -3853,7 +3869,16 @@ defineExpose({ focusSearch, insertCommand, executeCommand: executeAiCommand });
</Pane>
</Splitpanes>
- <DangerConfirmDialog v-model:open="showDangerConfirm" :message="dangerMessage" :details="dangerDetails" :confirm-label="dangerConfirmLabel" :loading="deletingKeys" :close-on-confirm="pendingDanger?.kind === 'delete-keys' || pendingDanger?.kind === 'delete-group'" @confirm="applyDangerAction" />
+ <DangerConfirmDialog
+ v-model:open="showDangerConfirm"
+ :message="dangerMessage"
+ :details-text="dangerDetailsText"
+ :sql="dangerSql"
+ :confirm-label="dangerConfirmLabel"
+ :loading="deletingKeys"
+ :close-on-confirm="pendingDanger?.kind === 'delete-keys' || pendingDanger?.kind === 'delete-group'"
+ @confirm="applyDangerAction"
+ />
<Dialog :open="showBatchExpiryDialog" @update:open="onBatchExpiryDialogOpenChange">
<DialogContent class="sm:max-w-[420px]">
diff --git a/apps/desktop/src/components/redis/RedisValueViewer.vue b/apps/desktop/src/components/redis/RedisValueViewer.vue
index 71ad427373..02f3320922 100644
--- a/apps/desktop/src/components/redis/RedisValueViewer.vue
+++ b/apps/desktop/src/components/redis/RedisValueViewer.vue
@@ -17,6 +17,7 @@ import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@
import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger } from "@/components/ui/dropdown-menu";
import AutoRefreshControl from "@/components/common/AutoRefreshControl.vue";
import DangerConfirmDialog from "@/components/editor/DangerConfirmDialog.vue";
+import { redisDeleteValueItemPreview } from "@/lib/redis/redisCommandPreview";
import { jsonTreeSearchParts, type JsonTreeSearchMatch } from "@/lib/common/jsonTreeSearch";
import { createTextContentSearchPattern, type TextContentMatch } from "@/lib/common/textContentSearch";
import { startRedisContentSearch } from "@/lib/redis/redisContentSearchJob";
@@ -1757,7 +1758,7 @@ function rawRedisValueText(value: unknown): string {
return formatRedisMemberDetail(value).rawText;
}
-const deleteDetails = computed(() => {
+const deleteDetailsText = computed(() => {
const pending = pendingDelete.value;
if (!pending) return "";
const key = formatValue(props.keyDisplay);
@@ -1768,6 +1769,12 @@ const deleteDetails = computed(() => {
return t("dangerDialog.redisSetMemberDetails", { key, member: formatValue(pending.member) });
});
+const deleteSql = computed(() => {
+ const pending = pendingDelete.value;
+ if (!pending) return "";
+ return redisDeleteValueItemPreview(props.keyDisplay || props.keyRaw, pending);
+});
+
async function load(options: { background?: boolean; notifyParent?: boolean; preserveDraft?: boolean; selectDefaultMember?: boolean; shouldApply?: () => boolean } = {}): Promise<boolean> {
const background = options.background ?? false;
const notifyParent = options.notifyParent ?? true;
@@ -3864,7 +3871,7 @@ useUpdateBlocker(() => (hasUnsavedRedisDraft.value || editingTtl.value || saving
</div>
</template>
- <DangerConfirmDialog v-model:open="showDeleteConfirm" :message="t('dangerDialog.deleteMessage')" :details="deleteDetails" :confirm-label="t('dangerDialog.deleteConfirm')" @confirm="confirmDelete" />
+ <DangerConfirmDialog v-model:open="showDeleteConfirm" :message="t('dangerDialog.deleteMessage')" :details-text="deleteDetailsText" :sql="deleteSql" :confirm-label="t('dangerDialog.deleteConfirm')" @confirm="confirmDelete" />
<Dialog :open="showRenameKeyDialog" @update:open="handleRenameKeyDialogOpenChange">
<DialogContent class="sm:max-w-md" :show-close-button="!renamingKey" :style="editorFontFamilyStyle">
diff --git a/apps/desktop/src/components/redis/__tests__/RedisDangerCommandPreview.spec.ts b/apps/desktop/src/components/redis/__tests__/RedisDangerCommandPreview.spec.ts
new file mode 100644
index 0000000000..713a7d47d2
--- /dev/null
+++ b/apps/desktop/src/components/redis/__tests__/RedisDangerCommandPreview.spec.ts
@@ -0,0 +1,178 @@
+// @vitest-environment happy-dom
+
+import { createApp, defineComponent, h, nextTick, reactive, type App } from "vue";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import i18n from "@/i18n";
+import DangerConfirmDialog from "@/components/editor/DangerConfirmDialog.vue";
+import { copyToClipboard } from "@/lib/common/clipboard";
+import { redisFlushDbPreview, redisDeleteKeysPreview, redisDeleteGroupPreview, redisDeleteValueItemPreview } from "@/lib/redis/redisCommandPreview";
+
+vi.mock("@/composables/useSqlHighlighter", () => ({
+ useSqlHighlighter: () => ({ highlight: (sql: string) => `<span>${sql}</span>` }),
+}));
+
+vi.mock("@/lib/common/clipboard", () => ({
+ copyToClipboard: vi.fn(),
+}));
+
+const mountedApps: App[] = [];
+
+async function mountDangerDialog(props: Record<string, unknown>) {
+ const state = reactive({ open: true });
+ const container = document.createElement("div");
+ document.body.append(container);
+ const app = createApp(
+ defineComponent({
+ setup: () => () =>
+ h(DangerConfirmDialog, {
+ open: state.open,
+ ...props,
+ "onUpdate:open": (value: boolean) => {
+ state.open = value;
+ },
+ }),
+ }),
+ );
+ mountedApps.push(app);
+ app.use(i18n);
+ app.mount(container);
+ await nextTick();
+ await new Promise((resolve) => setTimeout(resolve, 0));
+ return container;
+}
+
+afterEach(() => {
+ for (const app of mountedApps.splice(0)) app.unmount();
+ document.body.innerHTML = "";
+ vi.mocked(copyToClipboard).mockClear();
+});
+
+describe("Redis DangerConfirmDialog copy command behavior (issue #12892)", () => {
+ it("copies the FLUSHDB command instead of the details text", async () => {
+ const sql = redisFlushDbPreview(6);
+ const detailsText = "目标: Redis db6\n范围: 当前 DB 的所有 key";
+
+ await mountDangerDialog({
+ title: "清空当前 DB",
+ message: "这会删除当前 Redis 数据库中的所有 key,且不可撤销。确认继续?",
+ detailsText,
+ sql,
+ });
+
+ const codeContainer = document.body.querySelector('[data-testid="danger-code-container"]');
+ expect(codeContainer).not.toBeNull();
+ expect(codeContainer?.textContent).toContain("SELECT 6");
+ expect(codeContainer?.textContent).toContain("FLUSHDB");
+ expect(codeContainer?.textContent).not.toContain("目标: Redis db6");
+
+ const copyBtn = document.body.querySelector<HTMLButtonElement>('[data-testid="danger-code-actions"] button');
+ expect(copyBtn).not.toBeNull();
+ copyBtn?.click();
+ await nextTick();
+
+ expect(copyToClipboard).toHaveBeenCalledWith("SELECT 6\nFLUSHDB");
+ });
+
+ it("copies DEL command when batch deleting keys instead of description text", async () => {
+ const keys = ["user:1", "user:2", "cache:session with space"];
+ const sql = redisDeleteKeysPreview(keys);
+ const detailsText = "已选择的 key\n3 个 key";
+
+ await mountDangerDialog({
+ title: "删除确认",
+ message: "确认删除选中的内容?",
+ detailsText,
+ sql,
+ });
+
+ const codeContainer = document.body.querySelector('[data-testid="danger-code-container"]');
+ expect(codeContainer?.textContent).toContain("DEL user:1 user:2");
+ expect(codeContainer?.textContent).toContain('"cache:session with space"');
+
+ const copyBtn = document.body.querySelector<HTMLButtonElement>('[data-testid="danger-code-actions"] button');
+ copyBtn?.click();
+ await nextTick();
+
+ expect(copyToClipboard).toHaveBeenCalledWith('DEL user:1 user:2 "cache:session with space"');
+ });
+
+ it("copies EVAL script when deleting a group instead of subtree description text", async () => {
+ const pattern = "app:cache:*";
+ const sql = redisDeleteGroupPreview(pattern);
+ const detailsText = "app:cache\n将删除该分组下的全部 key(已加载 10 个)";
+
+ await mountDangerDialog({
+ title: "删除确认",
+ message: "确认删除选中的内容?",
+ detailsText,
+ sql,
+ });
+
+ const codeContainer = document.body.querySelector('[data-testid="danger-code-container"]');
+ expect(codeContainer?.textContent).toContain("EVAL");
+ expect(codeContainer?.textContent).toContain("app:cache:*");
+
+ const copyBtn = document.body.querySelector<HTMLButtonElement>('[data-testid="danger-code-actions"] button');
+ copyBtn?.click();
+ await nextTick();
+
+ expect(copyToClipboard).toHaveBeenCalledWith("EVAL \"local keys = redis.call('keys', ARGV[1]) for _, k in ipairs(keys) do redis.call('del', k) end return #keys\" 0 app:cache:*");
+ });
+
+ it("copies HDEL command when deleting a hash field in RedisValueViewer", async () => {
+ const sql = redisDeleteValueItemPreview("user:profile", { kind: "hash", field: "email" });
+ const detailsText = "Redis key:user:profile\nField: email";
+
+ await mountDangerDialog({
+ title: "删除确认",
+ message: "确认删除选中的内容?",
+ detailsText,
+ sql,
+ });
+
+ const codeContainer = document.body.querySelector('[data-testid="danger-code-container"]');
+ expect(codeContainer?.textContent).toContain("HDEL user:profile email");
+
+ const copyBtn = document.body.querySelector<HTMLButtonElement>('[data-testid="danger-code-actions"] button');
+ copyBtn?.click();
+ await nextTick();
+
+ expect(copyToClipboard).toHaveBeenCalledWith("HDEL user:profile email");
+ });
+
+ it("copies SREM command when deleting a set member in RedisValueViewer", async () => {
+ const sql = redisDeleteValueItemPreview("tags:article", { kind: "set", member: "news" });
+ const detailsText = "Redis key:tags:article\nMember: news";
+
+ await mountDangerDialog({
+ title: "删除确认",
+ message: "确认删除选中的内容?",
+ detailsText,
+ sql,
+ });
+
+ const copyBtn = document.body.querySelector<HTMLButtonElement>('[data-testid="danger-code-actions"] button');
+ copyBtn?.click();
+ await nextTick();
+
+ expect(copyToClipboard).toHaveBeenCalledWith("SREM tags:article news");
+ });
+
+ it("copies ZREM command when deleting a zset member in RedisValueViewer", async () => {
+ const sql = redisDeleteValueItemPreview("leaderboard", { kind: "zset", member: "player1" });
+ const detailsText = "Redis key:leaderboard\nMember: player1";
+
+ await mountDangerDialog({
+ title: "删除确认",
+ message: "确认删除选中的内容?",
+ detailsText,
+ sql,
+ });
+
+ const copyBtn = document.body.querySelector<HTMLButtonElement>('[data-testid="danger-code-actions"] button');
+ copyBtn?.click();
+ await nextTick();
+
+ expect(copyToClipboard).toHaveBeenCalledWith("ZREM leaderboard player1");
+ });
+});
diff --git a/apps/desktop/src/components/sidebar/SidebarTreeRuntimeHost.vue b/apps/desktop/src/components/sidebar/SidebarTreeRuntimeHost.vue
index cbd25d0ee2..96e4eae1d4 100644
--- a/apps/desktop/src/components/sidebar/SidebarTreeRuntimeHost.vue
+++ b/apps/desktop/src/components/sidebar/SidebarTreeRuntimeHost.vue
@@ -202,6 +202,7 @@ import { executeOceanbaseTableClone, executeOceanbaseTableCloneData, oceanbaseCl
import type { DuplicateTableStructurePlan } from "@/lib/database/dbAdminSql";
import { useOceanbaseCloneDialog } from "@/composables/useOceanbaseCloneDialog";
import DangerConfirmDialog from "@/components/editor/DangerConfirmDialog.vue";
+import { redisFlushDbPreview } from "@/lib/redis/redisCommandPreview";
import { buildRenameObjectSql, buildRenameDatabaseSql, buildRenameDatabasePreflightSql, databaseRenameMaintenanceDatabase, supportsDatabaseRename, supportsObjectRename, type RenameableObjectType } from "@/lib/table/objectRenameSql";
import { prepareOracleViewRename, executeOracleViewRename, OracleViewRenameFailure, type OracleViewRenamePlan } from "@/lib/table/oracleViewRename";
import { prepareOracleRoutineRename, executeOracleRoutineRename, OracleRoutineRenameFailure, type OracleRoutineRenamePlan } from "@/lib/table/oracleRoutineRename";
@@ -6302,15 +6303,17 @@ routeDangerDialog(showClearElasticsearchIndexConfirm, () => {
});
});
-routeDangerDialog(showFlushRedisDbConfirm, () =>
- dangerRequest({
+routeDangerDialog(showFlushRedisDbConfirm, () => {
+ const node = sidebarDangerTarget.value ?? activeNode.value;
+ return dangerRequest({
title: t("redis.flushDb"),
message: t("redis.flushDbMessage"),
- details: t("redis.flushDbDetails", { db: activeNode.value.database }),
+ detailsText: t("redis.flushDbDetails", { db: node.database ?? "" }),
+ sql: redisFlushDbPreview(node.database),
confirmLabel: t("redis.flushDbConfirm"),
confirm: confirmFlushRedisDb,
- }),
-);
+ });
+});
routeDangerDialog(showDropSchemaConfirm, () =>
dangerRequest({
diff --git a/apps/desktop/src/lib/redis/__tests__/redisCommandPreview.spec.ts b/apps/desktop/src/lib/redis/__tests__/redisCommandPreview.spec.ts
new file mode 100644
index 0000000000..f0a3c81cbc
--- /dev/null
+++ b/apps/desktop/src/lib/redis/__tests__/redisCommandPreview.spec.ts
@@ -0,0 +1,101 @@
+import { describe, expect, it } from "vitest";
+import { quoteRedisArg, redisFlushDbPreview, redisDeleteKeysPreview, redisDeleteGroupPreview, redisDeleteValueItemPreview } from "../redisCommandPreview";
+
+describe("quoteRedisArg", () => {
+ it("quotes empty string", () => {
+ expect(quoteRedisArg("")).toBe('""');
+ });
+
+ it("leaves simple keys unquoted", () => {
+ expect(quoteRedisArg("simple_key")).toBe("simple_key");
+ expect(quoteRedisArg("user:123:profile")).toBe("user:123:profile");
+ expect(quoteRedisArg("cache-key.v1")).toBe("cache-key.v1");
+ });
+
+ it("quotes keys with whitespace", () => {
+ expect(quoteRedisArg("key with space")).toBe('"key with space"');
+ expect(quoteRedisArg("key\twith\ttab")).toBe('"key\\twith\\ttab"');
+ expect(quoteRedisArg("key\nwith\nnewline")).toBe('"key\\nwith\\nnewline"');
+ });
+
+ it("quotes keys with quotes or backslashes", () => {
+ expect(quoteRedisArg('key"with"doublequote')).toBe('"key\\"with\\"doublequote"');
+ expect(quoteRedisArg("key'with'singlequote")).toBe("\"key'with'singlequote\"");
+ expect(quoteRedisArg("key\\with\\backslash")).toBe('"key\\\\with\\\\backslash"');
+ });
+});
+
+describe("redisFlushDbPreview", () => {
+ it("prefixes with SELECT when database is provided", () => {
+ expect(redisFlushDbPreview(6)).toBe("SELECT 6\nFLUSHDB");
+ expect(redisFlushDbPreview("6")).toBe("SELECT 6\nFLUSHDB");
+ expect(redisFlushDbPreview("db6")).toBe("SELECT 6\nFLUSHDB");
+ expect(redisFlushDbPreview(0)).toBe("SELECT 0\nFLUSHDB");
+ expect(redisFlushDbPreview("0")).toBe("SELECT 0\nFLUSHDB");
+ expect(redisFlushDbPreview("db0")).toBe("SELECT 0\nFLUSHDB");
+ });
+
+ it("returns FLUSHDB when database is absent or empty", () => {
+ expect(redisFlushDbPreview(undefined)).toBe("FLUSHDB");
+ expect(redisFlushDbPreview(null)).toBe("FLUSHDB");
+ expect(redisFlushDbPreview("")).toBe("FLUSHDB");
+ expect(redisFlushDbPreview(" ")).toBe("FLUSHDB");
+ });
+});
+
+describe("redisDeleteKeysPreview", () => {
+ it("returns empty string when key list is empty", () => {
+ expect(redisDeleteKeysPreview([])).toBe("");
+ });
+
+ it("formats single key deletion", () => {
+ expect(redisDeleteKeysPreview(["user:1"])).toBe("DEL user:1");
+ expect(redisDeleteKeysPreview(["key with space"])).toBe('DEL "key with space"');
+ });
+
+ it("formats multiple key deletions on a single line within chunkSize", () => {
+ const keys = ["k1", "k2", "k3", "k4 with space"];
+ expect(redisDeleteKeysPreview(keys)).toBe('DEL k1 k2 k3 "k4 with space"');
+ });
+
+ it("chunks large key lists across multiple DEL lines", () => {
+ const keys = Array.from({ length: 7 }, (_, i) => `key:${i + 1}`);
+ const preview = redisDeleteKeysPreview(keys, 3);
+ expect(preview).toBe("DEL key:1 key:2 key:3\nDEL key:4 key:5 key:6\nDEL key:7");
+ });
+});
+
+describe("redisDeleteGroupPreview", () => {
+ it("formats EVAL command with pattern parameter", () => {
+ expect(redisDeleteGroupPreview("user:*")).toBe("EVAL \"local keys = redis.call('keys', ARGV[1]) for _, k in ipairs(keys) do redis.call('del', k) end return #keys\" 0 user:*");
+ });
+
+ it("quotes pattern if it contains whitespace", () => {
+ expect(redisDeleteGroupPreview("group with space:*")).toBe("EVAL \"local keys = redis.call('keys', ARGV[1]) for _, k in ipairs(keys) do redis.call('del', k) end return #keys\" 0 \"group with space:*\"");
+ });
+});
+
+describe("redisDeleteValueItemPreview", () => {
+ it("formats key deletion", () => {
+ expect(redisDeleteValueItemPreview("user:100", { kind: "key" })).toBe("DEL user:100");
+ expect(redisDeleteValueItemPreview("key with space", { kind: "key" })).toBe('DEL "key with space"');
+ });
+
+ it("formats hash field deletion", () => {
+ expect(redisDeleteValueItemPreview("user:100", { kind: "hash", field: "email" })).toBe("HDEL user:100 email");
+ expect(redisDeleteValueItemPreview("user:100", { kind: "hash", field: "full name" })).toBe('HDEL user:100 "full name"');
+ });
+
+ it("formats set member deletion", () => {
+ expect(redisDeleteValueItemPreview("tags", { kind: "set", member: "vip" })).toBe("SREM tags vip");
+ expect(redisDeleteValueItemPreview("tags", { kind: "set", member: "top customer" })).toBe('SREM tags "top customer"');
+ });
+
+ it("formats zset member deletion", () => {
+ expect(redisDeleteValueItemPreview("leaderboard", { kind: "zset", member: "player1" })).toBe("ZREM leaderboard player1");
+ });
+
+ it("formats list index removal", () => {
+ expect(redisDeleteValueItemPreview("queue", { kind: "list", index: 2 })).toBe('LSET queue 2 "__DELETED_PLACEHOLDER__"\nLREM queue 1 "__DELETED_PLACEHOLDER__"');
+ });
+});
diff --git a/apps/desktop/src/lib/redis/redisCommandPreview.ts b/apps/desktop/src/lib/redis/redisCommandPreview.ts
new file mode 100644
index 0000000000..083ceb8d50
--- /dev/null
+++ b/apps/desktop/src/lib/redis/redisCommandPreview.ts
@@ -0,0 +1,65 @@
+/**
+ * Helpers for formatting Redis mutation commands for preview and clipboard copy
+ * in DangerConfirmDialog and related confirmation prompts.
+ */
+
+export type RedisValuePendingDelete = { kind: "key" } | { kind: "hash"; field: unknown } | { kind: "list"; index: number } | { kind: "set"; member: unknown } | { kind: "zset"; member: unknown };
+
+/**
+ * Quotes an argument for Redis command execution if it contains spaces,
+ * quotes, backslashes, control characters, or is empty.
+ */
+export function quoteRedisArg(arg: string): string {
+ if (arg.length === 0) return '""';
+ if (/[\s"'\\]/.test(arg)) {
+ return JSON.stringify(arg);
+ }
+ return arg;
+}
+
+/**
+ * Returns the command preview for flushing a Redis database.
+ * If database is provided, prefixes with `SELECT <db>`.
+ */
+export function redisFlushDbPreview(database?: string | number | null): string {
+ if (database != null && String(database).trim() !== "") {
+ const dbIndex = String(database).trim().replace(/^db/i, "");
+ return `SELECT ${dbIndex}\nFLUSHDB`;
+ }
+ return "FLUSHDB";
+}
+
+/**
+ * Formats a list of Redis keys into `DEL` commands.
+ * If keys exceed chunkSize, chunks them across multiple `DEL` lines.
+ */
+export function redisDeleteKeysPreview(keys: readonly string[], chunkSize = 50): string {
+ if (keys.length === 0) return "";
+ const quoted = keys.map(quoteRedisArg);
+ const lines: string[] = [];
+ const size = Math.max(1, chunkSize);
+ for (let i = 0; i < quoted.length; i += size) {
+ lines.push(`DEL ${quoted.slice(i, i + size).join(" ")}`);
+ }
+ return lines.join("\n");
+}
+
+/**
+ * Formats a pattern deletion preview into the standard server-side Lua EVAL command.
+ */
+export function redisDeleteGroupPreview(pattern: string): string {
+ const quoted = quoteRedisArg(pattern);
+ return `EVAL "local keys = redis.call('keys', ARGV[1]) for _, k in ipairs(keys) do redis.call('del', k) end return #keys" 0 ${quoted}`;
+}
+
+/**
+ * Formats a single item or key deletion within RedisValueViewer into an executable command.
+ */
+export function redisDeleteValueItemPreview(keyName: string, pending: RedisValuePendingDelete): string {
+ const key = quoteRedisArg(keyName);
+ if (pending.kind === "key") return `DEL ${key}`;
+ if (pending.kind === "hash") return `HDEL ${key} ${quoteRedisArg(String(pending.field ?? ""))}`;
+ if (pending.kind === "list") return `LSET ${key} ${pending.index} "__DELETED_PLACEHOLDER__"\nLREM ${key} 1 "__DELETED_PLACEHOLDER__"`;
+ if (pending.kind === "zset") return `ZREM ${key} ${quoteRedisArg(String(pending.member ?? ""))}`;
+ return `SREM ${key} ${quoteRedisArg(String(pending.member ?? ""))}`;
+}