@aster-cloud/aster-lang-ts 0.0.1

package/dist/test/unit/package-registry.test.js

@@ -0,0 +1,198 @@
+/**
+ * PackageRegistry GitHub API 交互层单元测试
+ *
+ * 覆盖成功解析版本、rate limit、网络异常、404、下载与速率查询场景。
+ */
+import test from 'node:test';
+import assert from 'node:assert';
+import { mkdtemp, readFile, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import nock from 'nock';
+import { PackageRegistry } from '../../src/package/package-registry.js';
+const API_BASE = 'https://api.github.com';
+function isDiagnostic(value) {
+    return Array.isArray(value) && value.length > 0 && value[0] && typeof value[0] === 'object' && 'severity' in value[0];
+}
+const createRegistry = () => new PackageRegistry({
+    baseUrl: API_BASE,
+    timeout: 2_000,
+});
+test('PackageRegistry GitHub API 交互层', async (t) => {
+    await t.before(() => {
+        nock.disableNetConnect();
+    });
+    await t.after(() => {
+        nock.enableNetConnect();
+        nock.cleanAll();
+    });
+    await t.afterEach(() => {
+        nock.cleanAll();
+    });
+    await t.test('应解析 release 列表并过滤非法版本与包', async () => {
+        nock(API_BASE)
+            .get('/repos/aster-lang/packages/releases')
+            .query({ per_page: '100' })
+            .reply(200, [
+            {
+                tag_name: 'v1.2.0',
+                assets: [
+                    {
+                        name: 'aster.http-1.2.0.tar.gz',
+                        browser_download_url: 'https://objects.githubusercontent.com/file1',
+                    },
+                ],
+            },
+            {
+                tag_name: 'beta',
+                assets: [
+                    {
+                        name: 'aster.http-beta.tar.gz',
+                        browser_download_url: 'https://objects.githubusercontent.com/file2',
+                    },
+                ],
+            },
+            {
+                tag_name: '1.1.0',
+                assets: [
+                    {
+                        name: 'aster.http-1.1.0.tar.gz',
+                        browser_download_url: 'https://objects.githubusercontent.com/file3',
+                    },
+                ],
+            },
+            {
+                tag_name: '1.0.0',
+                assets: [
+                    {
+                        name: 'aster.other-1.0.0.tar.gz',
+                        browser_download_url: 'https://objects.githubusercontent.com/file4',
+                    },
+                ],
+            },
+        ]);
+        const registry = createRegistry();
+        const result = await registry.listVersions('aster.http');
+        assert.ok(!(result instanceof Error), `应返回版本数组而非 Error，实际：${result}`);
+        assert.deepStrictEqual(result.sort(), ['1.1.0', '1.2.0']);
+    });
+    await t.test('listVersions 遇到 rate limit 应返回错误', async () => {
+        const resetEpoch = Math.floor(Date.now() / 1000) + 60;
+        nock(API_BASE)
+            .get('/repos/aster-lang/packages/releases')
+            .query({ per_page: '100' })
+            .reply(403, { message: 'API rate limit exceeded' }, {
+            'X-RateLimit-Remaining': '0',
+            'X-RateLimit-Reset': String(resetEpoch),
+        });
+        const registry = createRegistry();
+        const result = await registry.listVersions('aster.http');
+        assert.ok(isDiagnostic(result), '应返回 Diagnostic[]');
+        if (isDiagnostic(result)) {
+            assert.match(result[0]?.message ?? '', /速率限制/, '错误信息应包含速率限制提示');
+        }
+    });
+    await t.test('listVersions 遇到网络错误应返回 Error', async () => {
+        nock(API_BASE)
+            .get('/repos/aster-lang/packages/releases')
+            .query({ per_page: '100' })
+            .replyWithError(new Error('socket hang up'));
+        const registry = createRegistry();
+        const result = await registry.listVersions('aster.http');
+        assert.ok(isDiagnostic(result), '应返回 Diagnostic[]');
+        if (isDiagnostic(result)) {
+            assert.match(result[0]?.message ?? '', /socket hang up/, '错误信息应包含底层异常描述');
+        }
+    });
+    await t.test('listVersions 404 应告知资源不存在', async () => {
+        nock(API_BASE)
+            .get('/repos/aster-lang/packages/releases')
+            .query({ per_page: '100' })
+            .reply(404, { message: 'Not Found' });
+        const registry = createRegistry();
+        const result = await registry.listVersions('aster.http');
+        assert.ok(isDiagnostic(result), '应返回 Diagnostic[]');
+        if (isDiagnostic(result)) {
+            assert.match(result[0]?.message ?? '', /404/, '应提及 404 状态');
+        }
+    });
+    await t.test('downloadPackage 应下载 tarball 并写入目标路径', async () => {
+        nock(API_BASE)
+            .get('/repos/aster-lang/packages/releases/tags/1.2.0')
+            .reply(404, { message: 'Not Found' });
+        nock(API_BASE)
+            .get('/repos/aster-lang/packages/releases/tags/v1.2.0')
+            .reply(200, {
+            tag_name: 'v1.2.0',
+            assets: [
+                {
+                    name: 'aster.http-1.2.0.tar.gz',
+                    browser_download_url: 'https://objects.githubusercontent.com/downloads/file.tar.gz',
+                    size: 14,
+                },
+            ],
+        });
+        const tarball = Buffer.from('fake tarball');
+        nock('https://objects.githubusercontent.com')
+            .get('/downloads/file.tar.gz')
+            .reply(200, tarball, {
+            'Content-Length': String(tarball.length),
+        });
+        const tempDir = await mkdtemp(join(tmpdir(), 'pkg-registry-test-'));
+        const destPath = join(tempDir, 'aster-http.tar.gz');
+        try {
+            const registry = createRegistry();
+            const result = await registry.downloadPackage('aster.http', '1.2.0', destPath);
+            assert.ok(!isDiagnostic(result), `下载应成功，实际得到：${isDiagnostic(result) ? result[0]?.message : 'OK'}`);
+            const content = await readFile(destPath);
+            assert.deepStrictEqual(content, tarball);
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+    await t.test('downloadPackage 找不到 asset 应返回错误', async () => {
+        nock(API_BASE)
+            .get('/repos/aster-lang/packages/releases/tags/1.0.0')
+            .reply(200, {
+            tag_name: '1.0.0',
+            assets: [
+                {
+                    name: 'aster.other-1.0.0.tar.gz',
+                    browser_download_url: 'https://objects.githubusercontent.com/other.tar.gz',
+                },
+            ],
+        });
+        const registry = createRegistry();
+        const result = await registry.downloadPackage('aster.http', '1.0.0', '/tmp/unused');
+        assert.ok(isDiagnostic(result), '应返回 Diagnostic[]');
+        if (isDiagnostic(result)) {
+            assert.match(result[0]?.message ?? '', /未找到/, '需要提示缺少匹配 asset');
+        }
+    });
+    await t.test('checkRateLimit 应从响应头解析 limit 信息', async () => {
+        const resetEpoch = Math.floor(Date.now() / 1000) + 120;
+        nock(API_BASE)
+            .get('/rate_limit')
+            .reply(200, {
+            rate: {
+                limit: 60,
+                remaining: 42,
+                reset: resetEpoch,
+            },
+        }, {
+            'X-RateLimit-Limit': '60',
+            'X-RateLimit-Remaining': '42',
+            'X-RateLimit-Reset': String(resetEpoch),
+        });
+        const registry = createRegistry();
+        const result = await registry.checkRateLimit();
+        assert.ok(!isDiagnostic(result), `应返回 RateLimitInfo，实际：${result}`);
+        if (!isDiagnostic(result)) {
+            assert.strictEqual(result.limit, 60);
+            assert.strictEqual(result.remaining, 42);
+            assert.ok(Math.abs(result.reset.getTime() - resetEpoch * 1000) < 1000);
+        }
+    });
+});
+//# sourceMappingURL=package-registry.test.js.map

package/dist/test/unit/package-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-registry.test.js","sourceRoot":"","sources":["../../../test/unit/package-registry.test.ts"],"names":[],"mappings":"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"}

package/dist/test/unit/parser/parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parser.test.d.ts.map

package/dist/test/unit/parser/parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.test.d.ts","sourceRoot":"","sources":["../../../../test/unit/parser/parser.test.ts"],"names":[],"mappings":""}