@hangox/mg-cli 1.0.0

package/tests/unit/shared/errors.test.ts

@@ -0,0 +1,82 @@
+/**
+ * 错误处理测试
+ */
+
+import { describe, it, expect } from 'vitest'
+import {
+  ErrorCode,
+  ErrorNames,
+  ErrorMessages,
+  MGError,
+  createError,
+} from '../../../src/shared/errors.js'
+
+describe('ErrorCode', () => {
+  it('应该包含所有预定义错误码', () => {
+    expect(ErrorCode.CONNECTION_FAILED).toBe('E001')
+    expect(ErrorCode.NODE_NOT_FOUND).toBe('E005')
+    expect(ErrorCode.INVALID_LINK).toBe('E010')
+    expect(ErrorCode.SERVER_ALREADY_RUNNING).toBe('E016')
+  })
+})
+
+describe('ErrorNames', () => {
+  it('应该为每个错误码提供名称', () => {
+    expect(ErrorNames[ErrorCode.CONNECTION_FAILED]).toBe('CONNECTION_FAILED')
+    expect(ErrorNames[ErrorCode.NODE_NOT_FOUND]).toBe('NODE_NOT_FOUND')
+  })
+})
+
+describe('ErrorMessages', () => {
+  it('应该为每个错误码提供默认消息', () => {
+    expect(ErrorMessages[ErrorCode.CONNECTION_FAILED]).toBe('无法连接到 MG Server')
+    expect(ErrorMessages[ErrorCode.NODE_NOT_FOUND]).toBe('节点不存在')
+  })
+})
+
+describe('MGError', () => {
+  it('应该创建带有默认消息的错误', () => {
+    const error = new MGError(ErrorCode.NODE_NOT_FOUND)
+    expect(error.code).toBe('E005')
+    expect(error.errorName).toBe('NODE_NOT_FOUND')
+    expect(error.message).toBe('节点不存在')
+  })
+
+  it('应该创建带有自定义消息的错误', () => {
+    const error = new MGError(ErrorCode.NODE_NOT_FOUND, '节点 123:456 不存在')
+    expect(error.message).toBe('节点 123:456 不存在')
+  })
+
+  it('应该支持 details', () => {
+    const error = new MGError(ErrorCode.NODE_NOT_FOUND, '节点不存在', {
+      nodeId: '123:456',
+    })
+    expect(error.details).toEqual({ nodeId: '123:456' })
+  })
+
+  it('应该正确序列化为 JSON', () => {
+    const error = new MGError(ErrorCode.NODE_NOT_FOUND, '节点不存在', {
+      nodeId: '123:456',
+    })
+    const json = error.toJSON()
+    expect(json).toEqual({
+      code: 'E005',
+      name: 'NODE_NOT_FOUND',
+      message: '节点不存在',
+      details: { nodeId: '123:456' },
+    })
+  })
+
+  it('应该正确转换为字符串', () => {
+    const error = new MGError(ErrorCode.NODE_NOT_FOUND)
+    expect(error.toString()).toBe('错误 [E005]: 节点不存在')
+  })
+})
+
+describe('createError', () => {
+  it('应该创建 MGError 实例', () => {
+    const error = createError(ErrorCode.INVALID_LINK)
+    expect(error).toBeInstanceOf(MGError)
+    expect(error.code).toBe('E010')
+  })
+})

package/tests/unit/shared/utils.test.ts

@@ -0,0 +1,208 @@
+/**
+ * 工具函数测试
+ */
+
+import { describe, it, expect } from 'vitest'
+import {
+  normalizePageUrl,
+  isDesignPageUrl,
+  parseMgpLink,
+  generateMgpLink,
+  formatFileSize,
+  formatDuration,
+  generateId,
+  extractFileId,
+  extractFileIdFromUrl,
+  extractFileIdFromMgpLink,
+} from '../../../src/shared/utils.js'
+
+describe('normalizePageUrl', () => {
+  it('应该标准化完整 URL', () => {
+    const url =
+      'https://mastergo.netease.com/file/174135798361888?fileOpenFrom=home&page_id=0%3A8347'
+    const result = normalizePageUrl(url)
+    expect(result).toBe('mastergo.netease.com/file/174135798361888')
+  })
+
+  it('应该处理不带查询参数的 URL', () => {
+    const url = 'https://mastergo.netease.com/file/174135798361888'
+    const result = normalizePageUrl(url)
+    expect(result).toBe('mastergo.netease.com/file/174135798361888')
+  })
+
+  it('应该处理已标准化的 URL', () => {
+    const url = 'mastergo.netease.com/file/174135798361888'
+    const result = normalizePageUrl(url)
+    expect(result).toBe('mastergo.netease.com/file/174135798361888')
+  })
+
+  it('应该处理 mastergo.com 域名', () => {
+    const url = 'https://mastergo.com/file/123456'
+    const result = normalizePageUrl(url)
+    expect(result).toBe('mastergo.com/file/123456')
+  })
+})
+
+describe('isDesignPageUrl', () => {
+  it('应该识别设计页面 URL', () => {
+    expect(isDesignPageUrl('/file/174135798361888')).toBe(true)
+    expect(isDesignPageUrl('mastergo.com/file/123456')).toBe(true)
+  })
+
+  it('应该拒绝非设计页面 URL', () => {
+    expect(isDesignPageUrl('/files/home')).toBe(false)
+    expect(isDesignPageUrl('/files/recent')).toBe(false)
+    expect(isDesignPageUrl('/files/trash')).toBe(false)
+  })
+})
+
+describe('parseMgpLink', () => {
+  it('应该解析有效的 mgp:// 链接', () => {
+    const link = 'mgp://mastergo.netease.com/file/174135798361888?nodeId=123%3A456'
+    const result = parseMgpLink(link)
+    expect(result).toEqual({
+      pageUrl: 'mastergo.netease.com/file/174135798361888',
+      nodeId: '123:456',
+    })
+  })
+
+  it('应该解析 mastergo.com 域名的链接', () => {
+    const link = 'mgp://mastergo.com/file/123456?nodeId=789%3A101'
+    const result = parseMgpLink(link)
+    expect(result).toEqual({
+      pageUrl: 'mastergo.com/file/123456',
+      nodeId: '789:101',
+    })
+  })
+
+  it('应该解析带父节点路径的链接', () => {
+    const link = 'mgp://mastergo.netease.com/file/174875497054651?nodeId=0%3A8633&nodePath=314%3A13190%2F0%3A8633'
+    const result = parseMgpLink(link)
+    expect(result).toEqual({
+      pageUrl: 'mastergo.netease.com/file/174875497054651',
+      nodeId: '0:8633',
+      nodePath: ['314:13190', '0:8633'],
+    })
+  })
+
+  it('应该解析多层父节点路径的链接', () => {
+    const link = 'mgp://mastergo.netease.com/file/123?nodeId=3%3A3&nodePath=1%3A1%2F2%3A2%2F3%3A3'
+    const result = parseMgpLink(link)
+    expect(result).toEqual({
+      pageUrl: 'mastergo.netease.com/file/123',
+      nodeId: '3:3',
+      nodePath: ['1:1', '2:2', '3:3'],
+    })
+  })
+
+  it('应该解析 nodeId 包含路径格式的链接', () => {
+    // 用户直接复制的链接，nodeId 中包含路径
+    const link = 'mgp://mastergo.netease.com/file/174875497054651?nodeId=314%3A24807%2F0%3A3443'
+    const result = parseMgpLink(link)
+    expect(result).toEqual({
+      pageUrl: 'mastergo.netease.com/file/174875497054651',
+      nodeId: '314:24807/0:3443',
+    })
+  })
+
+  it('应该拒绝无效的链接', () => {
+    // 不是 mgp:// 协议
+    expect(parseMgpLink('https://mastergo.com/file/123?nodeId=1%3A2')).toBeNull()
+    // 没有 nodeId 参数
+    expect(parseMgpLink('mgp://mastergo.com/file/123')).toBeNull()
+    // nodeId 格式不对（没有编码）
+    expect(parseMgpLink('mgp://mastergo.com/file/123?nodeId=invalid')).toBeNull()
+    // 完全无效
+    expect(parseMgpLink('invalid')).toBeNull()
+    // 没有查询参数
+    expect(parseMgpLink('mgp://custom.domain.com/design/abc123')).toBeNull()
+  })
+})
+
+describe('generateMgpLink', () => {
+  it('应该生成正确的 mgp:// 链接', () => {
+    const pageUrl = 'https://mastergo.netease.com/file/174135798361888'
+    const nodeId = '123:456'
+    const result = generateMgpLink(pageUrl, nodeId)
+    expect(result).toBe('mgp://mastergo.netease.com/file/174135798361888?nodeId=123%3A456')
+  })
+
+  it('应该生成带 nodePath 的链接', () => {
+    const pageUrl = 'https://mastergo.netease.com/file/123'
+    const nodeId = '3:3'
+    const nodePath = ['1:1', '2:2', '3:3']
+    const result = generateMgpLink(pageUrl, nodeId, nodePath)
+    expect(result).toBe('mgp://mastergo.netease.com/file/123?nodeId=3%3A3&nodePath=1%3A1%2F2%3A2%2F3%3A3')
+  })
+})
+
+describe('formatFileSize', () => {
+  it('应该格式化字节大小', () => {
+    expect(formatFileSize(500)).toBe('500 字节')
+    expect(formatFileSize(1024)).toBe('1.00 KB')
+    expect(formatFileSize(1536)).toBe('1.50 KB')
+    expect(formatFileSize(1048576)).toBe('1.00 MB')
+  })
+})
+
+describe('formatDuration', () => {
+  it('应该格式化时间间隔', () => {
+    expect(formatDuration(5000)).toBe('5 秒')
+    expect(formatDuration(65000)).toBe('1 分钟 5 秒')
+    expect(formatDuration(3665000)).toBe('1 小时 1 分钟')
+    expect(formatDuration(90000000)).toBe('1 天 1 小时')
+  })
+})
+
+describe('generateId', () => {
+  it('应该生成唯一 ID', () => {
+    const id1 = generateId()
+    const id2 = generateId()
+    expect(id1).not.toBe(id2)
+    expect(id1).toMatch(/^\d+_[a-z0-9]+$/)
+  })
+})
+
+describe('extractFileIdFromUrl', () => {
+  it('应该从完整 URL 提取 fileId', () => {
+    expect(extractFileIdFromUrl('https://mastergo.netease.com/file/174875497054651?page_id=321%3A11979')).toBe('174875497054651')
+    expect(extractFileIdFromUrl('https://mastergo.netease.com/file/123456')).toBe('123456')
+    expect(extractFileIdFromUrl('mastergo.netease.com/file/789')).toBe('789')
+  })
+
+  it('应该处理无效 URL', () => {
+    expect(extractFileIdFromUrl('https://mastergo.netease.com/files/home')).toBeNull()
+    expect(extractFileIdFromUrl('invalid')).toBeNull()
+  })
+})
+
+describe('extractFileIdFromMgpLink', () => {
+  it('应该从 mgp:// 链接提取 fileId', () => {
+    expect(extractFileIdFromMgpLink('mgp://mastergo.netease.com/file/174875497054651?nodeId=xxx')).toBe('174875497054651')
+  })
+
+  it('应该拒绝非 mgp:// 链接', () => {
+    expect(extractFileIdFromMgpLink('https://mastergo.netease.com/file/123')).toBeNull()
+  })
+})
+
+describe('extractFileId', () => {
+  it('应该处理纯数字 fileId', () => {
+    expect(extractFileId('174875497054651')).toBe('174875497054651')
+    expect(extractFileId('  123456  ')).toBe('123456')
+  })
+
+  it('应该处理完整 URL', () => {
+    expect(extractFileId('https://mastergo.netease.com/file/174875497054651?page_id=xxx')).toBe('174875497054651')
+  })
+
+  it('应该处理 mgp:// 协议', () => {
+    expect(extractFileId('mgp://mastergo.netease.com/file/174875497054651?nodeId=xxx')).toBe('174875497054651')
+  })
+
+  it('应该处理无效输入', () => {
+    expect(extractFileId('invalid')).toBeNull()
+    expect(extractFileId('https://example.com')).toBeNull()
+  })
+  // 需要先导入
+})

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}

package/tsup.config.ts

@@ -0,0 +1,33 @@
+import { defineConfig } from 'tsup'
+
+export default defineConfig([
+  // 主模块（不需要 shebang）
+  {
+    entry: {
+      index: 'src/index.ts',
+      server: 'src/server/index.ts',
+    },
+    format: ['esm'],
+    dts: true,
+    clean: true,
+    sourcemap: true,
+    target: 'node20',
+    splitting: false,
+  },
+  // CLI 入口（需要 shebang）
+  {
+    entry: {
+      cli: 'src/cli/index.ts',
+      'daemon-runner': 'src/server/daemon-runner.ts',
+    },
+    format: ['esm'],
+    dts: false,
+    clean: false, // 不清理，避免覆盖上面的输出
+    sourcemap: true,
+    target: 'node20',
+    splitting: false,
+    banner: {
+      js: '#!/usr/bin/env node',
+    },
+  },
+])

package/vitest.config.ts

@@ -0,0 +1,22 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['tests/**/*.test.ts'],
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html'],
+      exclude: ['tests/**', 'dist/**', '*.config.*'],
+      thresholds: {
+        lines: 80,
+        functions: 80,
+        branches: 75,
+        statements: 80,
+      },
+    },
+    testTimeout: 10000,
+    hookTimeout: 10000,
+  },
+})