@aster-cloud/aster-lang-ts 0.0.1

package/dist/src/package/package-installer.js

@@ -0,0 +1,310 @@
+import { join } from 'node:path';
+import { mkdirSync, existsSync, rmSync, createReadStream } from 'node:fs';
+import { createHash } from 'node:crypto';
+import pLimit from 'p-limit';
+import { parseManifest } from './manifest-parser.js';
+import { maxSatisfying } from './version-utils.js';
+import { DependencyGraph } from './dependency-graph.js';
+import { updateLockfileEntry } from './lockfile.js';
+import { DiagnosticCode, DiagnosticBuilder, dummyPosition, } from '../diagnostics/diagnostics.js';
+function isDiagnostic(value) {
+    return Array.isArray(value) && value.length > 0 && value[0] && typeof value[0] === 'object' && 'severity' in value[0];
+}
+/**
+ * PackageInstaller 包安装协调器
+ *
+ * 职责：
+ * - 协调 PackageRegistry 和 PackageCache
+ * - 实现完整的包安装流程（查询、下载、解压、验证）
+ * - 支持单包安装、批量安装、离线模式
+ * - 更新 lockfile 并刷新 module_cache
+ */
+export class PackageInstaller {
+    registry;
+    cache;
+    moduleCache;
+    tempDir;
+    lockfilePath;
+    concurrencyLimit = pLimit(5);
+    constructor(registry, cache, moduleCache, tempDir, lockfilePath) {
+        this.registry = registry;
+        this.cache = cache;
+        this.moduleCache = moduleCache;
+        this.tempDir = tempDir || '/tmp/aster-installer';
+        this.lockfilePath = lockfilePath || '.aster.lock';
+        if (!existsSync(this.tempDir)) {
+            mkdirSync(this.tempDir, { recursive: true });
+        }
+    }
+    /**
+     * 安装单个包
+     *
+     * @param packageName - 包名称
+     * @param versionConstraint - 版本约束（例如 "^1.0.0", "1.2.3"）
+     * @returns 已安装的版本号，或 Diagnostic[]
+     */
+    async install(packageName, versionConstraint) {
+        // 1. 检查缓存（优先使用）
+        // 如果版本约束是精确版本（如 "1.0.0"），直接检查缓存
+        if (this.isExactVersion(versionConstraint)) {
+            if (this.cache.isCached(packageName, versionConstraint)) {
+                return versionConstraint; // 缓存命中
+            }
+        }
+        // 2. 查询可用版本列表
+        const versions = await this.registry.listVersions(packageName);
+        if (isDiagnostic(versions)) {
+            return versions;
+        }
+        // 3. 匹配版本约束（使用 version-utils）
+        const matchedVersion = maxSatisfying(versions, versionConstraint);
+        if (!matchedVersion) {
+            return [
+                DiagnosticBuilder.error(DiagnosticCode.V003_PackageNotFound)
+                    .withMessage(`找不到满足约束 ${versionConstraint} 的版本`)
+                    .withPosition(dummyPosition())
+                    .build()
+            ];
+        }
+        // 4. 再次检查缓存（针对匹配后的具体版本）
+        if (this.cache.isCached(packageName, matchedVersion)) {
+            return matchedVersion; // 缓存命中
+        }
+        // 5. 下载 .tar.gz
+        const tempPath = join(this.tempDir, `${packageName}-${matchedVersion}.tar.gz`);
+        const downloadResult = await this.registry.downloadPackage(packageName, matchedVersion, tempPath);
+        if (isDiagnostic(downloadResult)) {
+            return downloadResult;
+        }
+        // 6. 计算 SHA256 哈希
+        let integrity;
+        try {
+            integrity = await this.calculateHash(tempPath);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return [
+                DiagnosticBuilder.error(DiagnosticCode.C002_ExtractionFailed)
+                    .withMessage(`计算哈希失败：${message}`)
+                    .withPosition(dummyPosition())
+                    .build()
+            ];
+        }
+        // 7. 添加到缓存（解压）
+        const cacheResult = await this.cache.addToCache(tempPath, packageName, matchedVersion);
+        if (isDiagnostic(cacheResult)) {
+            return cacheResult;
+        }
+        // 8. 验证缓存完整性
+        const isValid = await this.cache.validateCache(packageName, matchedVersion);
+        if (!isValid) {
+            return [
+                DiagnosticBuilder.error(DiagnosticCode.C001_CacheCorrupted)
+                    .withMessage(`缓存验证失败：${packageName}@${matchedVersion}`)
+                    .withPosition(dummyPosition())
+                    .build()
+            ];
+        }
+        // 9. 更新 lockfile
+        const tarballUrl = `https://github.com/aster-lang/packages/releases/download/v${matchedVersion}/${packageName}-${matchedVersion}.tar.gz`;
+        const lockfileUpdate = updateLockfileEntry(this.lockfilePath, packageName, matchedVersion, tarballUrl, integrity);
+        if (lockfileUpdate instanceof Error) {
+            // Lockfile 更新失败不影响安装成功，只记录警告
+            // TODO: 添加日志记录
+        }
+        // 10. 刷新 module_cache
+        if (this.moduleCache) {
+            this.moduleCache.invalidatePackageCache(packageName);
+        }
+        // 11. 清理临时文件
+        try {
+            rmSync(tempPath, { force: true });
+        }
+        catch {
+            // 忽略清理错误
+        }
+        return matchedVersion; // 返回已安装版本
+    }
+    /**
+     * 批量安装（支持依赖解析）
+     *
+     * @param packages - 包名到版本约束的映射
+     * @returns 包名到已安装版本的映射，或 Diagnostic[]
+     */
+    async installMany(packages) {
+        const installedVersions = new Map();
+        const dependencyGraph = new DependencyGraph();
+        const errors = [];
+        // 第一阶段：并发安装所有根包并构建依赖图
+        const tasks = Array.from(packages.entries()).map(([packageName, versionConstraint]) => this.concurrencyLimit(async () => {
+            const version = await this.install(packageName, versionConstraint);
+            if (isDiagnostic(version)) {
+                errors.push(...version);
+                return;
+            }
+            installedVersions.set(packageName, version);
+            // 读取 manifest 获取依赖
+            const cachePath = this.cache.getCachePath(packageName, version);
+            const manifestPath = join(cachePath, 'manifest.json');
+            const manifest = parseManifest(manifestPath);
+            if (Array.isArray(manifest)) {
+                errors.push(DiagnosticBuilder.error(DiagnosticCode.M001_ManifestParseError)
+                    .withMessage(`解析 manifest 失败：${packageName}@${version}`)
+                    .withPosition(dummyPosition())
+                    .build());
+                return;
+            }
+            // 添加到依赖图
+            dependencyGraph.addNode(packageName, version);
+        }));
+        await Promise.all(tasks);
+        if (errors.length > 0) {
+            return errors;
+        }
+        // 第二阶段：并发安装所有传递依赖
+        const allDependencies = this.collectAllDependencies(installedVersions);
+        const depTasks = Array.from(allDependencies.entries())
+            .filter(([depName]) => !installedVersions.has(depName))
+            .map(([depName, depConstraint]) => this.concurrencyLimit(async () => {
+            const version = await this.install(depName, depConstraint);
+            if (isDiagnostic(version)) {
+                errors.push(...version);
+                return;
+            }
+            installedVersions.set(depName, version);
+            dependencyGraph.addNode(depName, version);
+        }));
+        await Promise.all(depTasks);
+        if (errors.length > 0) {
+            return errors;
+        }
+        // 第三阶段：构建依赖边
+        for (const [packageName, version] of installedVersions) {
+            const cachePath = this.cache.getCachePath(packageName, version);
+            const manifestPath = join(cachePath, 'manifest.json');
+            const manifest = parseManifest(manifestPath);
+            if (Array.isArray(manifest)) {
+                continue; // 跳过解析失败的包
+            }
+            if (manifest.dependencies) {
+                for (const depName of Object.keys(manifest.dependencies)) {
+                    const depVersion = installedVersions.get(depName);
+                    if (depVersion) {
+                        const fromId = `${packageName}@${version}`;
+                        const toId = `${depName}@${depVersion}`;
+                        try {
+                            dependencyGraph.addEdge(fromId, toId);
+                        }
+                        catch {
+                            // 忽略边添加失败（可能是节点不存在）
+                        }
+                    }
+                }
+            }
+        }
+        // 第四阶段：验证依赖图无循环
+        const sorted = dependencyGraph.topologicalSort();
+        if (sorted instanceof Error) {
+            return [
+                DiagnosticBuilder.error(DiagnosticCode.V002_VersionConflictUnresolvable)
+                    .withMessage(`检测到循环依赖：${sorted.message}`)
+                    .withPosition(dummyPosition())
+                    .build()
+            ];
+        }
+        return installedVersions;
+    }
+    /**
+     * 离线模式安装（仅使用缓存）
+     *
+     * @param packageName - 包名称
+     * @param version - 精确版本号
+     * @returns 版本号，或 Diagnostic[]
+     */
+    async installOffline(packageName, version) {
+        // 1. 检查缓存是否存在
+        if (!this.cache.isCached(packageName, version)) {
+            return [
+                DiagnosticBuilder.error(DiagnosticCode.C005_CacheExpired)
+                    .withMessage(`离线模式：缓存中未找到 ${packageName}@${version}。\n` +
+                    `提示：请先联网运行 \`aster install ${packageName}@${version}\` 下载包到缓存。`)
+                    .withPosition(dummyPosition())
+                    .build()
+            ];
+        }
+        // 2. 验证缓存完整性
+        const isValid = await this.cache.validateCache(packageName, version);
+        if (!isValid) {
+            return [
+                DiagnosticBuilder.error(DiagnosticCode.C001_CacheCorrupted)
+                    .withMessage(`缓存损坏：${packageName}@${version}。\n` +
+                    `提示：请运行 \`aster cache clean && aster install ${packageName}\` 重新下载。`)
+                    .withPosition(dummyPosition())
+                    .build()
+            ];
+        }
+        return version;
+    }
+    /**
+     * 收集所有传递依赖
+     *
+     * @param installedVersions - 已安装的包
+     * @returns 依赖名称到版本约束的映射
+     */
+    collectAllDependencies(installedVersions) {
+        const allDeps = new Map();
+        for (const [packageName, version] of installedVersions) {
+            const cachePath = this.cache.getCachePath(packageName, version);
+            const manifestPath = join(cachePath, 'manifest.json');
+            try {
+                const manifest = parseManifest(manifestPath);
+                if (Array.isArray(manifest)) {
+                    continue; // 跳过解析失败的包
+                }
+                if (manifest.dependencies) {
+                    for (const [depName, depConstraint] of Object.entries(manifest.dependencies)) {
+                        if (!allDeps.has(depName)) {
+                            allDeps.set(depName, depConstraint);
+                        }
+                    }
+                }
+            }
+            catch {
+                // 忽略错误，继续处理其他包
+            }
+        }
+        return allDeps;
+    }
+    /**
+     * 计算文件的 SHA256 哈希值
+     *
+     * @param filePath - 文件路径
+     * @returns SHA256 哈希值（十六进制字符串）
+     */
+    async calculateHash(filePath) {
+        return new Promise((resolve, reject) => {
+            const hash = createHash('sha256');
+            const stream = createReadStream(filePath);
+            stream.on('data', (chunk) => {
+                hash.update(chunk);
+            });
+            stream.on('end', () => {
+                resolve(hash.digest('hex'));
+            });
+            stream.on('error', (err) => {
+                reject(err);
+            });
+        });
+    }
+    /**
+     * 判断版本约束是否为精确版本
+     *
+     * @param versionConstraint - 版本约束
+     * @returns 是否为精确版本
+     */
+    isExactVersion(versionConstraint) {
+        // 精确版本格式：x.y.z（不含前缀符号）
+        return /^\d+\.\d+\.\d+$/.test(versionConstraint);
+    }
+}
+//# sourceMappingURL=package-installer.js.map

package/dist/src/package/package-installer.js.map

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

package/dist/src/package/package-registry.d.ts

@@ -0,0 +1,70 @@
+/**
+ * GitHub Releases API 交互层
+ *
+ * 提供包版本列表查询、tarball 下载与 rate limit 状态获取能力。
+ */
+import { type Diagnostic } from '../diagnostics/diagnostics.js';
+export interface RegistryConfig {
+    githubToken?: string;
+    timeout?: number;
+    baseUrl?: string;
+}
+export interface RateLimitInfo {
+    limit: number;
+    remaining: number;
+    reset: Date;
+}
+/**
+ * 基于 GitHub Releases 的包注册中心客户端
+ */
+export declare class PackageRegistry {
+    private readonly baseUrl;
+    private readonly baseOrigin;
+    private readonly timeout;
+    private readonly githubToken;
+    private readonly mode;
+    private readonly localRegistryDir?;
+    constructor(config?: RegistryConfig);
+    /**
+     * 列出指定包在 GitHub Releases 中可用的 SemVer 版本
+     *
+     * @param packageName 包名称（用于匹配 release assets）
+     * @returns 版本号数组或诊断错误
+     */
+    listVersions(packageName: string): Promise<string[] | Diagnostic[]>;
+    /**
+     * 下载指定包的 tarball 文件并写入目标路径
+     *
+     * @param packageName 包名称
+     * @param version 目标版本
+     * @param destPath 最终写入路径
+     */
+    downloadPackage(packageName: string, version: string, destPath: string): Promise<void | Diagnostic[]>;
+    /**
+     * 查询 GitHub API 的 rate limit 信息
+     */
+    checkRateLimit(): Promise<RateLimitInfo | Diagnostic[]>;
+    private shouldUseLocalRegistry;
+    private resolveLocalRegistryDir;
+    private locateWorkspaceLocalRegistry;
+    private listLocalVersions;
+    private downloadLocalPackage;
+    private fetchReleases;
+    private fetchReleaseByVersion;
+    private buildReleaseTagCandidates;
+    private normalizeTagName;
+    private releaseContainsPackage;
+    private findAssetForPackage;
+    private extractRateLimitInfo;
+    private parseNumberHeader;
+    private getJson;
+    private buildHttpDiagnostics;
+    private extractMessageFromBody;
+    private buildApiUrl;
+    private performBufferRequest;
+    private downloadAsset;
+    private isRedirect;
+    private isApiHost;
+    private buildHeaders;
+}
+//# sourceMappingURL=package-registry.d.ts.map

package/dist/src/package/package-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-registry.d.ts","sourceRoot":"","sources":["../../../src/package/package-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EACL,KAAK,UAAU,EAIhB,MAAM,+BAA+B,CAAC;AAiDvC,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,IAAI,CAAC;CACb;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAS;gBAE/B,MAAM,GAAE,cAAmB;IAoBvC;;;;;OAKG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IAuBzE;;;;;;OAMG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,UAAU,EAAE,CAAC;IAqC3G;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,aAAa,GAAG,UAAU,EAAE,CAAC;IAoB7D,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,4BAA4B;YAgBtB,iBAAiB;YAiDjB,oBAAoB;YAiCpB,aAAa;YAQb,qBAAqB;IAoBnC,OAAO,CAAC,yBAAyB;IAQjC,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,iBAAiB;YAWX,OAAO;IAoBrB,OAAO,CAAC,oBAAoB;IA4B5B,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,WAAW;YAcL,oBAAoB;YAqDpB,aAAa;IAkE3B,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,YAAY;CAUrB"}