feat(utils): 添加检查包版本的工具函数

- 新增 checkPkgVersion 函数，用于查询 npm 注册表中的包版本
- 函数支持指定包名、dist 标签和注册表地址
- 默认使用 'latest' 标签和官方 npm 注册表
- 添加了相关的单元测试用例

Author: cloudcome

src/utils.ts

@@ -1,5 +1,6 @@
 import { type ChildProcess, type ExecOptions, exec } from 'node:child_process';
 import fs from 'node:fs';
+import path from 'node:path';
 
 export function normalizePath(path: string) {
   return path.replace(/\\/g, '/');
@@ -30,3 +31,32 @@ export async function execCommand(
     });
   });
 }
+
+export type CheckPkgUpdate = {
+  /**
+   * Package name
+   */
+  name: string;
+  /**
+   * Dist tag
+   * @default 'latest'
+   * @see https://docs.npmjs.com/cli/dist-tag
+   */
+  distTag?: string;
+  /**
+   * NPM registry
+   * @default 'https://registry.npmjs.org'
+   */
+  registry?: string;
+};
+
+export async function checkPkgVersion(pkg: CheckPkgUpdate) {
+  const url = new URL(pkg.registry || 'https://registry.npmjs.org');
+  url.pathname = path.join(pkg.name, pkg.distTag || 'latest');
+  url.searchParams.set('t', process.env.TEST ? '1234567890' : Date.now().toString());
+
+  const resp = await fetch(url.toString());
+  const { version } = (await resp.json()) as { version: string };
+
+  return version;
+}

test/utils.test.ts

@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { afterAll, beforeAll, describe, expect, it } from 'vitest';
-import { execCommand, isDirectory, isFile, normalizePath } from '../src/utils';
+import { checkPkgVersion, execCommand, isDirectory, isFile, normalizePath } from '../src/utils';
 import { testRoot } from './helpers';
 
 let tempDir: string;
@@ -100,3 +100,37 @@ describe('execCommand', () => {
     expect(result.stdout.trim()).toBe('test-value');
   });
 });
+
+describe('checkPkgVersion', () => {
+  it('should return package version from npm registry', async () => {
+    const mockResponse = { version: '1.2.3' };
+    const mockFetch = vi.fn().mockResolvedValue({
+      json: () => Promise.resolve(mockResponse),
+    });
+    vi.stubGlobal('fetch', mockFetch);
+
+    const version = await checkPkgVersion({
+      name: 'test-package',
+      distTag: 'xxx',
+      registry: 'https://registry.npmjs.org',
+    });
+
+    expect(version).toBe('1.2.3');
+    expect(mockFetch).toHaveBeenCalledWith('https://registry.npmjs.org/test-package/xxx?t=1234567890');
+  });
+
+  it('should use default distTag and registry when not provided', async () => {
+    const mockResponse = { version: '1.0.0' };
+    const mockFetch = vi.fn().mockResolvedValue({
+      json: () => Promise.resolve(mockResponse),
+    });
+    vi.stubGlobal('fetch', mockFetch);
+
+    const version = await checkPkgVersion({
+      name: 'test-package',
+    });
+
+    expect(version).toBe('1.0.0');
+    expect(mockFetch).toHaveBeenCalledWith('https://registry.npmjs.org/test-package/latest?t=1234567890');
+  });
+});