@openclaw-china/shared 2026.3.22 → 2026.4.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw-china/shared",
-  "version": "2026.3.22",
+  "version": "2026.4.23",
   "type": "module",
   "exports": {
     ".": "./src/index.ts"

package/src/cli/china-setup.ts

@@ -51,7 +51,14 @@ type ConfigRoot = {
   [key: string]: unknown;
 };
 
-export type ChannelId = "dingtalk" | "feishu-china" | "wecom" | "wecom-app" | "wecom-kf" | "qqbot" | "wechat-mp";
+export type ChannelId =
+  | "dingtalk"
+  | "feishu-china"
+  | "wecom"
+  | "wecom-app"
+  | "wecom-kf"
+  | "qqbot-china"
+  | "wechat-mp";
 
 export type RegisterChinaSetupCliOptions = {
   channels?: readonly ChannelId[];
@@ -68,37 +75,38 @@ const GUIDES_BASE = "https://github.com/BytePioneer-AI/openclaw-china/tree/main/
 const OPENCLAW_HOME = join(homedir(), ".openclaw");
 const DEFAULT_PLUGIN_PATH = join(OPENCLAW_HOME, "extensions");
 const LEGACY_PLUGIN_PATH = join(OPENCLAW_HOME, "plugins");
-const CONFIG_FILE_PATH = join(OPENCLAW_HOME, "openclaw.json");
-const ANSI_RESET = "\u001b[0m";
-const ANSI_LINK = "\u001b[1;4;96m";
-const ANSI_BORDER = "\u001b[92m";
-const CHANNEL_ORDER: readonly ChannelId[] = [
-  "dingtalk",
-  "qqbot",
-  "wecom",
-  "wecom-app",
-  "wecom-kf",
+const CONFIG_FILE_PATH = join(OPENCLAW_HOME, "openclaw.json");
+const ANSI_RESET = "\u001b[0m";
+const ANSI_LINK = "\u001b[1;4;96m";
+const ANSI_BORDER = "\u001b[92m";
+const QQBOT_CHANNEL_ID = "qqbot-china" as const;
+const CHANNEL_ORDER: readonly ChannelId[] = [
+  "dingtalk",
+  QQBOT_CHANNEL_ID,
+  "wecom",
+  "wecom-app",
+  "wecom-kf",
   "wechat-mp",
   "feishu-china",
 ];
 const CHANNEL_DISPLAY_LABELS: Record<ChannelId, string> = {
   dingtalk: "DingTalk（钉钉）",
-  "feishu-china": "Feishu（飞书）",
-  wecom: "WeCom（企业微信-智能机器人）",
-  "wecom-app": "WeCom App（自建应用-可接入微信）",
-  "wecom-kf": "WeCom KF（微信客服）",
-  "wechat-mp": "WeChat MP（微信公众号）",
-  qqbot: "QQBot（QQ 机器人）",
-};
-const CHANNEL_GUIDE_LINKS: Record<ChannelId, string> = {
+  "feishu-china": "Feishu（飞书）",
+  wecom: "WeCom（企业微信-智能机器人）",
+  "wecom-app": "WeCom App（自建应用-可接入微信）",
+  "wecom-kf": "WeCom KF（微信客服）",
+  "wechat-mp": "WeChat MP（微信公众号）",
+  "qqbot-china": "QQBot（QQ 机器人）",
+};
+const CHANNEL_GUIDE_LINKS: Record<ChannelId, string> = {
   dingtalk: `${GUIDES_BASE}/dingtalk/configuration.md`,
   "feishu-china": "https://github.com/BytePioneer-AI/openclaw-china/blob/main/README.md",
   wecom: `${GUIDES_BASE}/wecom/configuration.md`,
-  "wecom-app": `${GUIDES_BASE}/wecom-app/configuration.md`,
-  "wecom-kf": "https://github.com/BytePioneer-AI/openclaw-china/blob/main/extensions/wecom-kf/README.md",
-  "wechat-mp": `${GUIDES_BASE}/wechat-mp/configuration.md`,
-  qqbot: `${GUIDES_BASE}/qqbot/configuration.md`,
-};
+  "wecom-app": `${GUIDES_BASE}/wecom-app/configuration.md`,
+  "wecom-kf": "https://github.com/BytePioneer-AI/openclaw-china/blob/main/extensions/wecom-kf/README.md",
+  "wechat-mp": `${GUIDES_BASE}/wechat-mp/configuration.md`,
+  "qqbot-china": `${GUIDES_BASE}/qqbot/configuration.md`,
+};
 const CHINA_CLI_STATE_KEY = Symbol.for("@openclaw-china/china-cli-state");
 
 type ChinaCliState = {
@@ -272,11 +280,11 @@ function cloneConfig(cfg: ConfigRoot): ConfigRoot {
   }
 }
 
-function getChannelConfig(cfg: ConfigRoot, channelId: ChannelId): ConfigRecord {
-  const channels = isRecord(cfg.channels) ? cfg.channels : {};
-  const existing = channels[channelId];
-  return isRecord(existing) ? existing : {};
-}
+function getChannelConfig(cfg: ConfigRoot, channelId: ChannelId): ConfigRecord {
+  const channels = isRecord(cfg.channels) ? cfg.channels : {};
+  const existing = channels[channelId];
+  return isRecord(existing) ? existing : {};
+}
 
 function getGatewayAuthToken(cfg: ConfigRoot): string | undefined {
   if (!isRecord(cfg.gateway)) {
@@ -328,15 +336,15 @@ function hasWecomWsCredentialPair(channelCfg: ConfigRecord): boolean {
   return hasCredentialPair(channelCfg, "botId", "secret");
 }
 
-function isChannelConfigured(cfg: ConfigRoot, channelId: ChannelId): boolean {
-  const channelCfg = getChannelConfig(cfg, channelId);
-  switch (channelId) {
+function isChannelConfigured(cfg: ConfigRoot, channelId: ChannelId): boolean {
+  const channelCfg = getChannelConfig(cfg, channelId);
+  switch (channelId) {
     case "dingtalk":
       return hasNonEmptyString(channelCfg.clientId) && hasNonEmptyString(channelCfg.clientSecret);
     case "feishu-china":
       return hasNonEmptyString(channelCfg.appId) && hasNonEmptyString(channelCfg.appSecret);
-    case "qqbot":
-      return hasNonEmptyString(channelCfg.appId) && hasNonEmptyString(channelCfg.clientSecret);
+    case "qqbot-china":
+      return hasNonEmptyString(channelCfg.appId) && hasNonEmptyString(channelCfg.clientSecret);
     case "wecom":
       return hasWecomWsCredentialPair(channelCfg);
     case "wecom-app":
@@ -359,21 +367,22 @@ function withConfiguredSuffix(cfg: ConfigRoot, channelId: ChannelId): string {
   return isChannelConfigured(cfg, channelId) ? `${base}（已配置）` : base;
 }
 
-function mergeChannelConfig(
-  cfg: ConfigRoot,
-  channelId: ChannelId,
-  patch: ConfigRecord
-): ConfigRoot {
-  const channels = isRecord(cfg.channels) ? { ...cfg.channels } : {};
-  const existing = getChannelConfig(cfg, channelId);
-  channels[channelId] = {
-    ...existing,
-    ...patch,
-    enabled: true,
-  };
-  return {
-    ...cfg,
-    channels,
+function mergeChannelConfig(
+  cfg: ConfigRoot,
+  channelId: ChannelId,
+  patch: ConfigRecord
+): ConfigRoot {
+  const channels = isRecord(cfg.channels) ? { ...cfg.channels } : {};
+  const existing = getChannelConfig(cfg, channelId);
+  const nextChannelConfig = {
+    ...existing,
+    ...patch,
+    enabled: true,
+  };
+  channels[channelId] = nextChannelConfig;
+  return {
+    ...cfg,
+    channels,
   };
 }
 
@@ -795,10 +804,10 @@ async function configureWechatMp(prompter: SetupPrompter, cfg: ConfigRoot): Prom
   });
 }
 
-async function configureQQBot(prompter: SetupPrompter, cfg: ConfigRoot): Promise<ConfigRoot> {
-  section("配置 QQBot（QQ 机器人）");
-  showGuideLink("qqbot");
-  const existing = getChannelConfig(cfg, "qqbot");
+async function configureQQBot(prompter: SetupPrompter, cfg: ConfigRoot): Promise<ConfigRoot> {
+  section("配置 QQBot（QQ 机器人）");
+  showGuideLink(QQBOT_CHANNEL_ID);
+  const existing = getChannelConfig(cfg, QQBOT_CHANNEL_ID);
   const existingAsr = isRecord(existing.asr) ? existing.asr : {};
 
   const appId = await prompter.askText({
@@ -838,10 +847,10 @@ async function configureQQBot(prompter: SetupPrompter, cfg: ConfigRoot): Promise
     });
   }
 
-  return mergeChannelConfig(cfg, "qqbot", {
-    appId,
-    clientSecret,
-    asr,
+  return mergeChannelConfig(cfg, QQBOT_CHANNEL_ID, {
+    appId,
+    clientSecret,
+    asr,
   });
 }
 
@@ -863,8 +872,8 @@ async function configureSingleChannel(
       return configureWecomKf(prompter, cfg);
     case "wechat-mp":
       return configureWechatMp(prompter, cfg);
-    case "qqbot":
-      return configureQQBot(prompter, cfg);
+    case "qqbot-china":
+      return configureQQBot(prompter, cfg);
     default:
       return cfg;
   }

package/src/cli/index.ts

@@ -1,2 +1,2 @@
-export * from "./china-setup.js";
-export * from "./install-hint.js";
+export * from "./china-setup.js";
+export * from "./install-hint.js";

package/src/cli/install-hint.ts

@@ -18,16 +18,16 @@ const ANSI_RESET = "\u001b[0m";
 const ANSI_BOLD = "\u001b[1m";
 const ANSI_LINK = "\u001b[1;4;96m";
 const ANSI_BORDER = "\u001b[92m";
-const SUPPORTED_CHANNELS: readonly ChannelId[] = [
-  "dingtalk",
-  "feishu-china",
-  "wecom",
-  "wecom-app",
-  "wecom-kf",
-  "wechat-mp",
-  "qqbot",
-];
-const CHINA_INSTALL_HINT_SHOWN_KEY = Symbol.for("@openclaw-china/china-install-hint-shown");
+const SUPPORTED_CHANNELS: readonly ChannelId[] = [
+  "dingtalk",
+  "feishu-china",
+  "wecom",
+  "wecom-app",
+  "wecom-kf",
+  "wechat-mp",
+  "qqbot-china",
+];
+const CHINA_INSTALL_HINT_SHOWN_KEY = Symbol.for("@openclaw-china/china-install-hint-shown");
 
 function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -42,12 +42,12 @@ function hasAnyEnabledChinaChannel(config: unknown): boolean {
   if (!isRecord(channels)) {
     return false;
   }
-
-  return SUPPORTED_CHANNELS.some((channelId) => {
-    const channelConfig = channels[channelId];
-    return isRecord(channelConfig) && channelConfig.enabled === true;
-  });
-}
+
+  return SUPPORTED_CHANNELS.some((channelId) => {
+    const channelConfig = channels[channelId];
+    return isRecord(channelConfig) && channelConfig.enabled === true;
+  });
+}
 
 function hasShownInstallHint(): boolean {
   const root = globalThis as Record<PropertyKey, unknown>;

package/src/cron/index.ts

@@ -1,21 +1,21 @@
-const CRON_HIDDEN_PROMPT = `
-When creating or updating a cron task, always store a fixed delivery target in the job itself.
-- Use the built-in cron tool (action=add/update). Do not run shell commands.
-- Must use sessionTarget="isolated" for reminder jobs.
-- payload.kind="agentTurn"
-- payload.message must be plain user-visible reminder text only.
-- You must encode runtime guardrails directly into payload.message so the cron run can follow them without extra context.
-- Runtime guardrails to encode in payload.message:
-  - return plain text only
-  - never call any tool
-  - never call the message tool
-  - never send manually; delivery is handled by cron delivery settings
-- Do not include tool directives, "NO_REPLY", or heartbeat markers in payload.message.
-- Job name is never a message target.
-- During cron run, must return plain text only and never call the message tool.
+const CRON_HIDDEN_PROMPT = `
+When creating or updating a cron task, always store a fixed delivery target in the job itself.
+- Use the built-in cron tool (action=add/update). Do not run shell commands.
+- Must use sessionTarget="isolated" for reminder jobs.
+- payload.kind="agentTurn"
+- payload.message must be plain user-visible reminder text only.
+- You must encode runtime guardrails directly into payload.message so the cron run can follow them without extra context.
+- Runtime guardrails to encode in payload.message:
+  - return plain text only
+  - never call any tool
+  - never call the message tool
+  - never send manually; delivery is handled by cron delivery settings
+- Do not include tool directives, "NO_REPLY", or heartbeat markers in payload.message.
+- Job name is never a message target.
+- During cron run, must return plain text only and never call the message tool.
 - Use top-level delivery with announce mode:
-  delivery.mode="announce"
-  delivery.channel=<OriginatingChannel> (example: "qqbot")
+  delivery.mode="announce"
+  delivery.channel=<OriginatingChannel> (example: "qqbot")
   delivery.to=<OriginatingTo> (examples: "user:<openid>" / "group:<group_openid>")
   delivery.accountId=<AccountId> when available
 - Never set delivery.channel="last" for multi-channel environments.

package/src/file/file-utils.test.ts

@@ -1,141 +1,141 @@
-/**
- * Unit Tests for File Utilities
- * 
- * Feature: dingtalk-media-receive
- * Validates: Requirements 5.1-5.8, 6.1-6.6
- */
-
-import { describe, it, expect } from "vitest";
-import { resolveFileCategory, resolveExtension } from "./file-utils.js";
-
-describe("resolveFileCategory", () => {
-  // Image categorization (Requirement 5.1)
-  it("should categorize image MIME types", () => {
-    expect(resolveFileCategory("image/jpeg")).toBe("image");
-    expect(resolveFileCategory("image/png")).toBe("image");
-    expect(resolveFileCategory("image/gif")).toBe("image");
-    expect(resolveFileCategory("image/webp")).toBe("image");
-    expect(resolveFileCategory("image/bmp")).toBe("image");
-  });
-
-  // Audio categorization (Requirement 5.2)
-  it("should categorize audio MIME types", () => {
-    expect(resolveFileCategory("audio/mpeg")).toBe("audio");
-    expect(resolveFileCategory("audio/wav")).toBe("audio");
-    expect(resolveFileCategory("audio/ogg")).toBe("audio");
-    expect(resolveFileCategory("audio/amr")).toBe("audio");
-  });
-
-  // Video categorization (Requirement 5.3)
-  it("should categorize video MIME types", () => {
-    expect(resolveFileCategory("video/mp4")).toBe("video");
-    expect(resolveFileCategory("video/quicktime")).toBe("video");
-    expect(resolveFileCategory("video/webm")).toBe("video");
-  });
-
-  // Document categorization (Requirement 5.4)
-  it("should categorize document MIME types", () => {
-    expect(resolveFileCategory("application/pdf")).toBe("document");
-    expect(resolveFileCategory("application/msword")).toBe("document");
-    expect(resolveFileCategory("text/plain")).toBe("document");
-    expect(resolveFileCategory("text/markdown")).toBe("document");
-  });
-
-  // Archive categorization (Requirement 5.5)
-  it("should categorize archive MIME types", () => {
-    expect(resolveFileCategory("application/zip")).toBe("archive");
-    expect(resolveFileCategory("application/x-rar-compressed")).toBe("archive");
-    expect(resolveFileCategory("application/x-7z-compressed")).toBe("archive");
-  });
-
-  // Code categorization (Requirement 5.6)
-  it("should categorize code MIME types", () => {
-    expect(resolveFileCategory("application/json")).toBe("code");
-    expect(resolveFileCategory("text/html")).toBe("code");
-    expect(resolveFileCategory("text/css")).toBe("code");
-    expect(resolveFileCategory("text/javascript")).toBe("code");
-  });
-
-  // Extension fallback (Requirement 5.8)
-  it("should use extension fallback when MIME type is unknown", () => {
-    expect(resolveFileCategory("application/octet-stream", "photo.jpg")).toBe("image");
-    expect(resolveFileCategory("application/octet-stream", "song.mp3")).toBe("audio");
-    expect(resolveFileCategory("application/octet-stream", "movie.mp4")).toBe("video");
-    expect(resolveFileCategory("application/octet-stream", "doc.pdf")).toBe("document");
-    expect(resolveFileCategory("application/octet-stream", "archive.zip")).toBe("archive");
-    expect(resolveFileCategory("application/octet-stream", "script.py")).toBe("code");
-  });
-
-  // Other category (Requirement 5.7)
-  it("should return 'other' for unknown types", () => {
-    expect(resolveFileCategory("application/octet-stream")).toBe("other");
-    expect(resolveFileCategory("application/unknown")).toBe("other");
-    expect(resolveFileCategory("application/octet-stream", "file.xyz")).toBe("other");
-  });
-
-  // MIME type normalization
-  it("should handle MIME types with parameters", () => {
-    expect(resolveFileCategory("image/jpeg; charset=utf-8")).toBe("image");
-    expect(resolveFileCategory("text/plain; charset=utf-8")).toBe("document");
-  });
-});
-
-describe("resolveExtension", () => {
-  // Image extensions (Requirement 6.1)
-  it("should resolve image MIME types to extensions", () => {
-    expect(resolveExtension("image/jpeg")).toBe(".jpg");
-    expect(resolveExtension("image/png")).toBe(".png");
-    expect(resolveExtension("image/gif")).toBe(".gif");
-    expect(resolveExtension("image/webp")).toBe(".webp");
-    expect(resolveExtension("image/bmp")).toBe(".bmp");
-  });
-
-  // Audio extensions (Requirement 6.2)
-  it("should resolve audio MIME types to extensions", () => {
-    expect(resolveExtension("audio/mpeg")).toBe(".mp3");
-    expect(resolveExtension("audio/wav")).toBe(".wav");
-    expect(resolveExtension("audio/ogg")).toBe(".ogg");
-    expect(resolveExtension("audio/amr")).toBe(".amr");
-    expect(resolveExtension("audio/x-m4a")).toBe(".m4a");
-  });
-
-  // Video extensions (Requirement 6.3)
-  it("should resolve video MIME types to extensions", () => {
-    expect(resolveExtension("video/mp4")).toBe(".mp4");
-    expect(resolveExtension("video/quicktime")).toBe(".mov");
-    expect(resolveExtension("video/x-msvideo")).toBe(".avi");
-    expect(resolveExtension("video/webm")).toBe(".webm");
-  });
-
-  // Document extensions (Requirement 6.4)
-  it("should resolve document MIME types to extensions", () => {
-    expect(resolveExtension("application/pdf")).toBe(".pdf");
-    expect(resolveExtension("application/msword")).toBe(".doc");
-    expect(resolveExtension("application/vnd.openxmlformats-officedocument.wordprocessingml.document")).toBe(".docx");
-  });
-
-  // Default extension (Requirement 6.5)
-  it("should return .bin for unknown MIME types", () => {
-    expect(resolveExtension("application/unknown")).toBe(".bin");
-    expect(resolveExtension("application/octet-stream")).toBe(".bin");
-  });
-
-  // fileName precedence (Requirement 6.6)
-  it("should use fileName extension when provided", () => {
-    expect(resolveExtension("application/octet-stream", "photo.jpg")).toBe(".jpg");
-    expect(resolveExtension("image/png", "custom.jpeg")).toBe(".jpeg");
-    expect(resolveExtension("application/unknown", "document.pdf")).toBe(".pdf");
-  });
-
-  // MIME type normalization
-  it("should handle MIME types with parameters", () => {
-    expect(resolveExtension("image/jpeg; charset=utf-8")).toBe(".jpg");
-    expect(resolveExtension("audio/mpeg; bitrate=320")).toBe(".mp3");
-  });
-
-  // Edge cases
-  it("should handle fileName without extension", () => {
-    expect(resolveExtension("image/jpeg", "photo")).toBe(".jpg");
-    expect(resolveExtension("application/unknown", "noext")).toBe(".bin");
-  });
-});
+/**
+ * Unit Tests for File Utilities
+ * 
+ * Feature: dingtalk-media-receive
+ * Validates: Requirements 5.1-5.8, 6.1-6.6
+ */
+
+import { describe, it, expect } from "vitest";
+import { resolveFileCategory, resolveExtension } from "./file-utils.js";
+
+describe("resolveFileCategory", () => {
+  // Image categorization (Requirement 5.1)
+  it("should categorize image MIME types", () => {
+    expect(resolveFileCategory("image/jpeg")).toBe("image");
+    expect(resolveFileCategory("image/png")).toBe("image");
+    expect(resolveFileCategory("image/gif")).toBe("image");
+    expect(resolveFileCategory("image/webp")).toBe("image");
+    expect(resolveFileCategory("image/bmp")).toBe("image");
+  });
+
+  // Audio categorization (Requirement 5.2)
+  it("should categorize audio MIME types", () => {
+    expect(resolveFileCategory("audio/mpeg")).toBe("audio");
+    expect(resolveFileCategory("audio/wav")).toBe("audio");
+    expect(resolveFileCategory("audio/ogg")).toBe("audio");
+    expect(resolveFileCategory("audio/amr")).toBe("audio");
+  });
+
+  // Video categorization (Requirement 5.3)
+  it("should categorize video MIME types", () => {
+    expect(resolveFileCategory("video/mp4")).toBe("video");
+    expect(resolveFileCategory("video/quicktime")).toBe("video");
+    expect(resolveFileCategory("video/webm")).toBe("video");
+  });
+
+  // Document categorization (Requirement 5.4)
+  it("should categorize document MIME types", () => {
+    expect(resolveFileCategory("application/pdf")).toBe("document");
+    expect(resolveFileCategory("application/msword")).toBe("document");
+    expect(resolveFileCategory("text/plain")).toBe("document");
+    expect(resolveFileCategory("text/markdown")).toBe("document");
+  });
+
+  // Archive categorization (Requirement 5.5)
+  it("should categorize archive MIME types", () => {
+    expect(resolveFileCategory("application/zip")).toBe("archive");
+    expect(resolveFileCategory("application/x-rar-compressed")).toBe("archive");
+    expect(resolveFileCategory("application/x-7z-compressed")).toBe("archive");
+  });
+
+  // Code categorization (Requirement 5.6)
+  it("should categorize code MIME types", () => {
+    expect(resolveFileCategory("application/json")).toBe("code");
+    expect(resolveFileCategory("text/html")).toBe("code");
+    expect(resolveFileCategory("text/css")).toBe("code");
+    expect(resolveFileCategory("text/javascript")).toBe("code");
+  });
+
+  // Extension fallback (Requirement 5.8)
+  it("should use extension fallback when MIME type is unknown", () => {
+    expect(resolveFileCategory("application/octet-stream", "photo.jpg")).toBe("image");
+    expect(resolveFileCategory("application/octet-stream", "song.mp3")).toBe("audio");
+    expect(resolveFileCategory("application/octet-stream", "movie.mp4")).toBe("video");
+    expect(resolveFileCategory("application/octet-stream", "doc.pdf")).toBe("document");
+    expect(resolveFileCategory("application/octet-stream", "archive.zip")).toBe("archive");
+    expect(resolveFileCategory("application/octet-stream", "script.py")).toBe("code");
+  });
+
+  // Other category (Requirement 5.7)
+  it("should return 'other' for unknown types", () => {
+    expect(resolveFileCategory("application/octet-stream")).toBe("other");
+    expect(resolveFileCategory("application/unknown")).toBe("other");
+    expect(resolveFileCategory("application/octet-stream", "file.xyz")).toBe("other");
+  });
+
+  // MIME type normalization
+  it("should handle MIME types with parameters", () => {
+    expect(resolveFileCategory("image/jpeg; charset=utf-8")).toBe("image");
+    expect(resolveFileCategory("text/plain; charset=utf-8")).toBe("document");
+  });
+});
+
+describe("resolveExtension", () => {
+  // Image extensions (Requirement 6.1)
+  it("should resolve image MIME types to extensions", () => {
+    expect(resolveExtension("image/jpeg")).toBe(".jpg");
+    expect(resolveExtension("image/png")).toBe(".png");
+    expect(resolveExtension("image/gif")).toBe(".gif");
+    expect(resolveExtension("image/webp")).toBe(".webp");
+    expect(resolveExtension("image/bmp")).toBe(".bmp");
+  });
+
+  // Audio extensions (Requirement 6.2)
+  it("should resolve audio MIME types to extensions", () => {
+    expect(resolveExtension("audio/mpeg")).toBe(".mp3");
+    expect(resolveExtension("audio/wav")).toBe(".wav");
+    expect(resolveExtension("audio/ogg")).toBe(".ogg");
+    expect(resolveExtension("audio/amr")).toBe(".amr");
+    expect(resolveExtension("audio/x-m4a")).toBe(".m4a");
+  });
+
+  // Video extensions (Requirement 6.3)
+  it("should resolve video MIME types to extensions", () => {
+    expect(resolveExtension("video/mp4")).toBe(".mp4");
+    expect(resolveExtension("video/quicktime")).toBe(".mov");
+    expect(resolveExtension("video/x-msvideo")).toBe(".avi");
+    expect(resolveExtension("video/webm")).toBe(".webm");
+  });
+
+  // Document extensions (Requirement 6.4)
+  it("should resolve document MIME types to extensions", () => {
+    expect(resolveExtension("application/pdf")).toBe(".pdf");
+    expect(resolveExtension("application/msword")).toBe(".doc");
+    expect(resolveExtension("application/vnd.openxmlformats-officedocument.wordprocessingml.document")).toBe(".docx");
+  });
+
+  // Default extension (Requirement 6.5)
+  it("should return .bin for unknown MIME types", () => {
+    expect(resolveExtension("application/unknown")).toBe(".bin");
+    expect(resolveExtension("application/octet-stream")).toBe(".bin");
+  });
+
+  // fileName precedence (Requirement 6.6)
+  it("should use fileName extension when provided", () => {
+    expect(resolveExtension("application/octet-stream", "photo.jpg")).toBe(".jpg");
+    expect(resolveExtension("image/png", "custom.jpeg")).toBe(".jpeg");
+    expect(resolveExtension("application/unknown", "document.pdf")).toBe(".pdf");
+  });
+
+  // MIME type normalization
+  it("should handle MIME types with parameters", () => {
+    expect(resolveExtension("image/jpeg; charset=utf-8")).toBe(".jpg");
+    expect(resolveExtension("audio/mpeg; bitrate=320")).toBe(".mp3");
+  });
+
+  // Edge cases
+  it("should handle fileName without extension", () => {
+    expect(resolveExtension("image/jpeg", "photo")).toBe(".jpg");
+    expect(resolveExtension("application/unknown", "noext")).toBe(".bin");
+  });
+});