@openclaw-china/shared 0.1.36 → 0.1.38

package/package.json

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

package/src/cli/china-setup.ts

@@ -63,7 +63,7 @@ type Option<T extends string> = {
   label: string;
 };
 
-const PROJECT_REPO = "https://github.com/BytePioneer-AI/moltbot-china";
+const PROJECT_REPO = "https://github.com/BytePioneer-AI/openclaw-china";
 const GUIDES_BASE = "https://github.com/BytePioneer-AI/openclaw-china/tree/main/doc/guides";
 const OPENCLAW_HOME = join(homedir(), ".openclaw");
 const DEFAULT_PLUGIN_PATH = join(OPENCLAW_HOME, "extensions");

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

@@ -1,95 +1,95 @@
-import type { ChannelId } from "./china-setup.js";
-
-type LoggerLike = {
-  info?: (message: string) => void;
-  warn?: (message: string) => void;
-};
-
-export type ChinaInstallHintApiLike = {
-  logger?: LoggerLike;
-  config?: unknown;
-  [key: string]: unknown;
-};
-
-const PROJECT_REPO = "https://github.com/BytePioneer-AI/moltbot-china";
-const INSTALL_SETUP_COMMAND = "openclaw china setup";
-const START_GATEWAY_COMMAND = "openclaw gateway --port 18789 --verbose";
-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",
-  "qqbot",
-];
-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);
-}
-
-function hasAnyEnabledChinaChannel(config: unknown): boolean {
-  if (!isRecord(config)) {
-    return false;
-  }
-
-  const channels = config.channels;
-  if (!isRecord(channels)) {
-    return false;
-  }
-
-  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>;
-  return root[CHINA_INSTALL_HINT_SHOWN_KEY] === true;
-}
-
-function markInstallHintShown(): void {
-  const root = globalThis as Record<PropertyKey, unknown>;
-  root[CHINA_INSTALL_HINT_SHOWN_KEY] = true;
-}
-
-export function showChinaInstallHint(api: ChinaInstallHintApiLike): void {
-  if (hasShownInstallHint() || hasAnyEnabledChinaChannel(api.config)) {
-    return;
-  }
-  markInstallHintShown();
-
-  const lines = [
-    `${ANSI_BORDER}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${ANSI_RESET}`,
-    "  OpenClaw China Channels 已就绪!",
-    `${ANSI_BORDER}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${ANSI_RESET}`,
-    "",
-    "项目仓库:",
-    `  ${ANSI_LINK}${PROJECT_REPO}${ANSI_RESET}`,
-    "",
-    "⭐ 如果这个项目对你有帮助，请给我们一个 Star！⭐",
-    "",
-    "下一步（配置引导）:",
-    "  1. 运行交互式配置向导",
-    `     ${ANSI_BOLD}${INSTALL_SETUP_COMMAND}${ANSI_RESET}`,
-    "  2. 按提示填写渠道凭据并保存配置",
-    "  3. 启动网关并观察日志",
-    `     ${START_GATEWAY_COMMAND}`,
-  ];
-
-  if (api.logger?.info) {
-    for (const line of lines) {
-      api.logger.info(line);
-    }
-    return;
-  }
-  if (api.logger?.warn) {
-    for (const line of lines) {
-      api.logger.warn(line);
-    }
-  }
-}
+import type { ChannelId } from "./china-setup.js";
+
+type LoggerLike = {
+  info?: (message: string) => void;
+  warn?: (message: string) => void;
+};
+
+export type ChinaInstallHintApiLike = {
+  logger?: LoggerLike;
+  config?: unknown;
+  [key: string]: unknown;
+};
+
+const PROJECT_REPO = "https://github.com/BytePioneer-AI/openclaw-china";
+const INSTALL_SETUP_COMMAND = "openclaw china setup";
+const START_GATEWAY_COMMAND = "openclaw gateway --port 18789 --verbose";
+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",
+  "qqbot",
+];
+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);
+}
+
+function hasAnyEnabledChinaChannel(config: unknown): boolean {
+  if (!isRecord(config)) {
+    return false;
+  }
+
+  const channels = config.channels;
+  if (!isRecord(channels)) {
+    return false;
+  }
+
+  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>;
+  return root[CHINA_INSTALL_HINT_SHOWN_KEY] === true;
+}
+
+function markInstallHintShown(): void {
+  const root = globalThis as Record<PropertyKey, unknown>;
+  root[CHINA_INSTALL_HINT_SHOWN_KEY] = true;
+}
+
+export function showChinaInstallHint(api: ChinaInstallHintApiLike): void {
+  if (hasShownInstallHint() || hasAnyEnabledChinaChannel(api.config)) {
+    return;
+  }
+  markInstallHintShown();
+
+  const lines = [
+    `${ANSI_BORDER}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${ANSI_RESET}`,
+    "  OpenClaw China Channels 已就绪!",
+    `${ANSI_BORDER}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${ANSI_RESET}`,
+    "",
+    "项目仓库:",
+    `  ${ANSI_LINK}${PROJECT_REPO}${ANSI_RESET}`,
+    "",
+    "⭐ 如果这个项目对你有帮助，请给我们一个 Star！⭐",
+    "",
+    "下一步（配置引导）:",
+    "  1. 运行交互式配置向导",
+    `     ${ANSI_BOLD}${INSTALL_SETUP_COMMAND}${ANSI_RESET}`,
+    "  2. 按提示填写渠道凭据并保存配置",
+    "  3. 启动网关并观察日志",
+    `     ${START_GATEWAY_COMMAND}`,
+  ];
+
+  if (api.logger?.info) {
+    for (const line of lines) {
+      api.logger.info(line);
+    }
+    return;
+  }
+  if (api.logger?.warn) {
+    for (const line of lines) {
+      api.logger.warn(line);
+    }
+  }
+}

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");
+  });
+});