@hangox/mg-cli 1.0.0 → 1.0.2

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

@@ -1,66 +0,0 @@
-/**
- * 常量测试
- */
-
-import { describe, it, expect } from 'vitest'
-import {
-  DEFAULT_PORT,
-  PORT_RANGE_START,
-  PORT_RANGE_END,
-  MAX_PORT_ATTEMPTS,
-  HEARTBEAT_INTERVAL,
-  HEARTBEAT_TIMEOUT,
-  ConnectionType,
-  MessageType,
-} from '../../../src/shared/constants.js'
-
-describe('端口配置', () => {
-  it('应该有正确的默认端口', () => {
-    expect(DEFAULT_PORT).toBe(9527)
-  })
-
-  it('应该有正确的端口范围', () => {
-    expect(PORT_RANGE_START).toBe(9527)
-    expect(PORT_RANGE_END).toBe(9536)
-  })
-
-  it('端口范围应该正好是 10 个', () => {
-    expect(PORT_RANGE_END - PORT_RANGE_START + 1).toBe(MAX_PORT_ATTEMPTS)
-  })
-})
-
-describe('心跳配置', () => {
-  it('应该有正确的心跳间隔', () => {
-    expect(HEARTBEAT_INTERVAL).toBe(30000) // 30 秒
-  })
-
-  it('应该有正确的心跳超时', () => {
-    expect(HEARTBEAT_TIMEOUT).toBe(90000) // 90 秒 = 3 次心跳
-  })
-
-  it('心跳超时应该是间隔的 3 倍', () => {
-    expect(HEARTBEAT_TIMEOUT).toBe(HEARTBEAT_INTERVAL * 3)
-  })
-})
-
-describe('ConnectionType', () => {
-  it('应该有 CONSUMER 和 PROVIDER 两种类型', () => {
-    expect(ConnectionType.CONSUMER).toBe('consumer')
-    expect(ConnectionType.PROVIDER).toBe('provider')
-  })
-})
-
-describe('MessageType', () => {
-  it('应该包含系统消息类型', () => {
-    expect(MessageType.PING).toBe('ping')
-    expect(MessageType.PONG).toBe('pong')
-    expect(MessageType.REGISTER).toBe('register')
-  })
-
-  it('应该包含业务消息类型', () => {
-    expect(MessageType.GET_NODE_BY_ID).toBe('get_node_by_id')
-    expect(MessageType.GET_ALL_NODES).toBe('get_all_nodes')
-    expect(MessageType.EXPORT_IMAGE).toBe('export_image')
-    expect(MessageType.EXECUTE_CODE).toBe('execute_code')
-  })
-})

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

@@ -1,82 +0,0 @@
-/**
- * 错误处理测试
- */
-
-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

@@ -1,208 +0,0 @@
-/**
- * 工具函数测试
- */
-
-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

@@ -1,22 +0,0 @@
-{
-  "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

@@ -1,33 +0,0 @@
-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

@@ -1,22 +0,0 @@
-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,
-  },
-})