grf-cli 1.0.2 → 1.0.4

package/dist/core/migration.js

@@ -0,0 +1,277 @@
+"use strict";
+/**
+ * grf 配置迁移工具
+ * 将旧版单一 config.json 文件迁移到新的模块化配置结构
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.needsMigration = needsMigration;
+exports.backupLegacyConfig = backupLegacyConfig;
+exports.migrateConfig = migrateConfig;
+exports.validateMigration = validateMigration;
+exports.ensureMigrated = ensureMigrated;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const paths_js_1 = require("./paths.js");
+const config_manager_js_1 = require("./config-manager.js");
+const repos_index_js_1 = require("./repos-index.js");
+// ============================================================================
+// 核心迁移函数
+// ============================================================================
+/**
+ * 检查是否需要迁移
+ * 条件：旧配置存在且新配置目录不存在或为空
+ * @returns 是否需要迁移
+ */
+async function needsMigration() {
+    try {
+        const legacyConfigPath = (0, paths_js_1.getLegacyConfigPath)();
+        const configDir = (0, paths_js_1.getConfigDir)();
+        const reposIndexPath = (0, paths_js_1.getReposIndexPath)();
+        // 检查旧配置文件是否存在
+        const legacyExists = await fs_extra_1.default.pathExists(legacyConfigPath);
+        if (!legacyExists) {
+            return false;
+        }
+        // 检查新配置目录是否存在
+        const configDirExists = await fs_extra_1.default.pathExists(configDir);
+        if (!configDirExists) {
+            return true;
+        }
+        // 检查新配置目录是否为空
+        const configDirContents = await fs_extra_1.default.readdir(configDir);
+        if (configDirContents.length === 0) {
+            return true;
+        }
+        // 检查 repos.json 是否存在
+        const reposIndexExists = await fs_extra_1.default.pathExists(reposIndexPath);
+        if (!reposIndexExists) {
+            // 如果旧配置有 repos 数据，需要迁移
+            const legacyConfig = await readLegacyConfig();
+            if (legacyConfig?.repos && Object.keys(legacyConfig.repos).length > 0) {
+                return true;
+            }
+        }
+        return false;
+    }
+    catch {
+        // 出错时保守处理，不执行迁移
+        return false;
+    }
+}
+/**
+ * 读取旧版配置文件
+ * @returns 旧版配置对象，如果不存在或解析失败则返回 null
+ */
+async function readLegacyConfig() {
+    try {
+        const legacyConfigPath = (0, paths_js_1.getLegacyConfigPath)();
+        const exists = await fs_extra_1.default.pathExists(legacyConfigPath);
+        if (!exists) {
+            return null;
+        }
+        const content = await fs_extra_1.default.readFile(legacyConfigPath, "utf-8");
+        const config = JSON.parse(content);
+        return config;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 备份旧配置文件
+ * @returns 备份文件路径，如果备份失败则返回 null
+ */
+async function backupLegacyConfig() {
+    try {
+        const legacyConfigPath = (0, paths_js_1.getLegacyConfigPath)();
+        const exists = await fs_extra_1.default.pathExists(legacyConfigPath);
+        if (!exists) {
+            return null;
+        }
+        const backupPath = `${legacyConfigPath}.backup`;
+        // 如果备份文件已存在，添加时间戳
+        let finalBackupPath = backupPath;
+        if (await fs_extra_1.default.pathExists(backupPath)) {
+            const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+            finalBackupPath = `${legacyConfigPath}.backup.${timestamp}`;
+        }
+        await fs_extra_1.default.copy(legacyConfigPath, finalBackupPath);
+        return finalBackupPath;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 执行配置迁移
+ * @returns 迁移结果
+ */
+async function migrateConfig() {
+    try {
+        // 检查是否需要迁移
+        const shouldMigrate = await needsMigration();
+        if (!shouldMigrate) {
+            return {
+                success: true,
+                migrated: false,
+                message: "无需迁移：旧配置不存在或新配置已存在",
+            };
+        }
+        // 读取旧配置
+        const legacyConfig = await readLegacyConfig();
+        if (!legacyConfig) {
+            return {
+                success: false,
+                migrated: false,
+                message: "迁移失败：无法读取旧配置文件",
+            };
+        }
+        // 备份旧配置
+        const backupPath = await backupLegacyConfig();
+        if (!backupPath) {
+            return {
+                success: false,
+                migrated: false,
+                message: "迁移失败：无法备份旧配置文件",
+            };
+        }
+        // 确保目录存在
+        await (0, paths_js_1.ensureGrfDirs)();
+        // 记录迁移的配置项
+        const configsMigrated = [];
+        // 迁移 version
+        const version = legacyConfig.version ?? config_manager_js_1.CONFIG_DEFAULTS.VERSION;
+        await config_manager_js_1.versionConfig.set(version);
+        configsMigrated.push("version");
+        // 迁移 defaultBranch
+        const defaultBranch = legacyConfig.defaultBranch ?? config_manager_js_1.CONFIG_DEFAULTS.DEFAULT_BRANCH;
+        await config_manager_js_1.defaultBranchConfig.set(defaultBranch);
+        configsMigrated.push("defaultBranch");
+        // 迁移 shallowClone
+        const shallowClone = legacyConfig.shallowClone ?? config_manager_js_1.CONFIG_DEFAULTS.SHALLOW_CLONE;
+        await config_manager_js_1.shallowCloneConfig.set(shallowClone);
+        configsMigrated.push("shallowClone");
+        // 迁移 shallowDepth
+        const shallowDepth = legacyConfig.shallowDepth ?? config_manager_js_1.CONFIG_DEFAULTS.SHALLOW_DEPTH;
+        await config_manager_js_1.shallowDepthConfig.set(shallowDepth);
+        configsMigrated.push("shallowDepth");
+        // 迁移 repos
+        const repos = legacyConfig.repos ?? {};
+        const repoCount = Object.keys(repos).length;
+        if (repoCount > 0) {
+            await repos_index_js_1.reposIndex.setAll(repos);
+        }
+        return {
+            success: true,
+            migrated: true,
+            message: `迁移成功：已迁移 ${configsMigrated.length} 个配置项和 ${repoCount} 个仓库`,
+            details: {
+                configsMigrated,
+                reposMigrated: repoCount,
+                backupPath,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            migrated: false,
+            message: `迁移失败：${error.message}`,
+        };
+    }
+}
+/**
+ * 验证迁移结果
+ * 检查新配置文件是否正确创建
+ * @returns 验证是否通过
+ */
+async function validateMigration() {
+    try {
+        // 检查各配置文件是否存在
+        const versionExists = await config_manager_js_1.versionConfig.exists();
+        const defaultBranchExists = await config_manager_js_1.defaultBranchConfig.exists();
+        const shallowCloneExists = await config_manager_js_1.shallowCloneConfig.exists();
+        const shallowDepthExists = await config_manager_js_1.shallowDepthConfig.exists();
+        // 所有配置文件都必须存在
+        if (!versionExists ||
+            !defaultBranchExists ||
+            !shallowCloneExists ||
+            !shallowDepthExists) {
+            return false;
+        }
+        // 尝试读取各配置值，确保格式正确
+        await config_manager_js_1.versionConfig.get();
+        await config_manager_js_1.defaultBranchConfig.get();
+        await config_manager_js_1.shallowCloneConfig.get();
+        await config_manager_js_1.shallowDepthConfig.get();
+        // 检查 repos.json 是否可读
+        const reposIndexPath = (0, paths_js_1.getReposIndexPath)();
+        const reposIndexExists = await fs_extra_1.default.pathExists(reposIndexPath);
+        if (reposIndexExists) {
+            await repos_index_js_1.reposIndex.getAll();
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// 自动迁移入口
+// ============================================================================
+/**
+ * 确保配置已迁移
+ * 在应用启动时调用，自动检测并执行迁移
+ * 此函数是幂等的，多次调用结果相同
+ * @returns 迁移结果
+ */
+async function ensureMigrated() {
+    try {
+        // 检查是否需要迁移
+        const shouldMigrate = await needsMigration();
+        if (!shouldMigrate) {
+            // 不需要迁移，检查是否已经迁移过
+            const isValid = await validateMigration();
+            if (isValid) {
+                return {
+                    success: true,
+                    migrated: false,
+                    message: "配置已是最新格式，无需迁移",
+                };
+            }
+            // 配置目录存在但验证失败，可能是首次运行
+            // 确保目录存在即可
+            await (0, paths_js_1.ensureGrfDirs)();
+            return {
+                success: true,
+                migrated: false,
+                message: "配置目录已初始化",
+            };
+        }
+        // 执行迁移
+        const result = await migrateConfig();
+        // 如果迁移成功，验证结果
+        if (result.success && result.migrated) {
+            const isValid = await validateMigration();
+            if (!isValid) {
+                return {
+                    success: false,
+                    migrated: true,
+                    message: "迁移完成但验证失败，配置文件可能不完整",
+                    details: result.details,
+                };
+            }
+        }
+        return result;
+    }
+    catch (error) {
+        return {
+            success: false,
+            migrated: false,
+            message: `自动迁移失败：${error.message}`,
+        };
+    }
+}
+//# sourceMappingURL=migration.js.map

package/dist/core/migration.js.map

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

package/dist/core/paths.d.ts

@@ -0,0 +1,58 @@
+/**
+ * grf 路径管理模块
+ * 集中管理所有配置文件路径
+ */
+/** grf 配置目录名称 */
+export declare const GRF_DIR_NAME = ".gitreference";
+/** 配置子目录名称 */
+export declare const CONFIG_DIR_NAME = "config";
+/** 各配置项的文件名 */
+export declare const CONFIG_FILES: {
+    readonly VERSION: "version.json";
+    readonly DEFAULT_BRANCH: "default-branch.json";
+    readonly SHALLOW_CLONE: "shallow-clone.json";
+    readonly SHALLOW_DEPTH: "shallow-depth.json";
+};
+/** 仓库索引文件名 */
+export declare const REPOS_INDEX_FILE = "repos.json";
+/** 加载状态文件名 */
+export declare const LOADING_STATE_FILE = "loading.json";
+/** 旧版配置文件名（用于迁移） */
+export declare const LEGACY_CONFIG_FILE = "config.json";
+/**
+ * 获取 .gitreference 根目录路径
+ * @returns grf 根目录的绝对路径 (~/.gitreference/)
+ */
+export declare function getGrfRoot(): string;
+/**
+ * 获取 config 子目录路径
+ * @returns 配置子目录的绝对路径 (~/.gitreference/config/)
+ */
+export declare function getConfigDir(): string;
+/**
+ * 获取特定配置文件路径
+ * @param configName 配置文件名（如 'version.json'）
+ * @returns 配置文件的绝对路径 (~/.gitreference/config/{configName})
+ */
+export declare function getConfigFilePath(configName: string): string;
+/**
+ * 获取仓库索引文件路径
+ * @returns 仓库索引文件的绝对路径 (~/.gitreference/repos.json)
+ */
+export declare function getReposIndexPath(): string;
+/**
+ * 获取加载状态文件路径
+ * @returns 加载状态文件的绝对路径 (~/.gitreference/loading.json)
+ */
+export declare function getLoadingStatePath(): string;
+/**
+ * 获取旧版配置文件路径（用于迁移）
+ * @returns 旧版配置文件的绝对路径 (~/.gitreference/config.json)
+ */
+export declare function getLegacyConfigPath(): string;
+/**
+ * 确保 grf 相关目录存在
+ * 如果目录不存在则创建
+ */
+export declare function ensureGrfDirs(): Promise<void>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/core/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,iBAAiB;AACjB,eAAO,MAAM,YAAY,kBAAkB,CAAC;AAE5C,cAAc;AACd,eAAO,MAAM,eAAe,WAAW,CAAC;AAMxC,eAAe;AACf,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX,cAAc;AACd,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAE7C,cAAc;AACd,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD,oBAAoB;AACpB,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAMhD;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAMD;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnD"}

package/dist/core/paths.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * grf 路径管理模块
+ * 集中管理所有配置文件路径
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEGACY_CONFIG_FILE = exports.LOADING_STATE_FILE = exports.REPOS_INDEX_FILE = exports.CONFIG_FILES = exports.CONFIG_DIR_NAME = exports.GRF_DIR_NAME = void 0;
+exports.getGrfRoot = getGrfRoot;
+exports.getConfigDir = getConfigDir;
+exports.getConfigFilePath = getConfigFilePath;
+exports.getReposIndexPath = getReposIndexPath;
+exports.getLoadingStatePath = getLoadingStatePath;
+exports.getLegacyConfigPath = getLegacyConfigPath;
+exports.ensureGrfDirs = ensureGrfDirs;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+// ============================================================================
+// 基础路径常量
+// ============================================================================
+/** grf 配置目录名称 */
+exports.GRF_DIR_NAME = ".gitreference";
+/** 配置子目录名称 */
+exports.CONFIG_DIR_NAME = "config";
+// ============================================================================
+// 配置文件名常量
+// ============================================================================
+/** 各配置项的文件名 */
+exports.CONFIG_FILES = {
+    VERSION: "version.json",
+    DEFAULT_BRANCH: "default-branch.json",
+    SHALLOW_CLONE: "shallow-clone.json",
+    SHALLOW_DEPTH: "shallow-depth.json",
+};
+/** 仓库索引文件名 */
+exports.REPOS_INDEX_FILE = "repos.json";
+/** 加载状态文件名 */
+exports.LOADING_STATE_FILE = "loading.json";
+/** 旧版配置文件名（用于迁移） */
+exports.LEGACY_CONFIG_FILE = "config.json";
+// ============================================================================
+// 路径获取函数
+// ============================================================================
+/**
+ * 获取 .gitreference 根目录路径
+ * @returns grf 根目录的绝对路径 (~/.gitreference/)
+ */
+function getGrfRoot() {
+    return path_1.default.join(os_1.default.homedir(), exports.GRF_DIR_NAME);
+}
+/**
+ * 获取 config 子目录路径
+ * @returns 配置子目录的绝对路径 (~/.gitreference/config/)
+ */
+function getConfigDir() {
+    return path_1.default.join(getGrfRoot(), exports.CONFIG_DIR_NAME);
+}
+/**
+ * 获取特定配置文件路径
+ * @param configName 配置文件名（如 'version.json'）
+ * @returns 配置文件的绝对路径 (~/.gitreference/config/{configName})
+ */
+function getConfigFilePath(configName) {
+    return path_1.default.join(getConfigDir(), configName);
+}
+/**
+ * 获取仓库索引文件路径
+ * @returns 仓库索引文件的绝对路径 (~/.gitreference/repos.json)
+ */
+function getReposIndexPath() {
+    return path_1.default.join(getGrfRoot(), exports.REPOS_INDEX_FILE);
+}
+/**
+ * 获取加载状态文件路径
+ * @returns 加载状态文件的绝对路径 (~/.gitreference/loading.json)
+ */
+function getLoadingStatePath() {
+    return path_1.default.join(getGrfRoot(), exports.LOADING_STATE_FILE);
+}
+/**
+ * 获取旧版配置文件路径（用于迁移）
+ * @returns 旧版配置文件的绝对路径 (~/.gitreference/config.json)
+ */
+function getLegacyConfigPath() {
+    return path_1.default.join(getGrfRoot(), exports.LEGACY_CONFIG_FILE);
+}
+// ============================================================================
+// 工具函数
+// ============================================================================
+/**
+ * 确保 grf 相关目录存在
+ * 如果目录不存在则创建
+ */
+async function ensureGrfDirs() {
+    const grfRoot = getGrfRoot();
+    const configDir = getConfigDir();
+    await fs_extra_1.default.ensureDir(grfRoot);
+    await fs_extra_1.default.ensureDir(configDir);
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;AA6CH,gCAEC;AAMD,oCAEC;AAOD,8CAEC;AAMD,8CAEC;AAMD,kDAEC;AAMD,kDAEC;AAUD,sCAMC;AAtGD,wDAA0B;AAC1B,4CAAoB;AACpB,gDAAwB;AAExB,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,iBAAiB;AACJ,QAAA,YAAY,GAAG,eAAe,CAAC;AAE5C,cAAc;AACD,QAAA,eAAe,GAAG,QAAQ,CAAC;AAExC,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,eAAe;AACF,QAAA,YAAY,GAAG;IAC1B,OAAO,EAAE,cAAc;IACvB,cAAc,EAAE,qBAAqB;IACrC,aAAa,EAAE,oBAAoB;IACnC,aAAa,EAAE,oBAAoB;CAC3B,CAAC;AAEX,cAAc;AACD,QAAA,gBAAgB,GAAG,YAAY,CAAC;AAE7C,cAAc;AACD,QAAA,kBAAkB,GAAG,cAAc,CAAC;AAEjD,oBAAoB;AACP,QAAA,kBAAkB,GAAG,aAAa,CAAC;AAEhD,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E;;;GAGG;AACH,SAAgB,UAAU;IACxB,OAAO,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,oBAAY,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY;IAC1B,OAAO,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,uBAAe,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,UAAkB;IAClD,OAAO,cAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,wBAAgB,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB;IACjC,OAAO,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,0BAAkB,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB;IACjC,OAAO,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,0BAAkB,CAAC,CAAC;AACrD,CAAC;AAED,+EAA+E;AAC/E,OAAO;AACP,+EAA+E;AAE/E;;;GAGG;AACI,KAAK,UAAU,aAAa;IACjC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IAEjC,MAAM,kBAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC5B,MAAM,kBAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;AAChC,CAAC"}

package/dist/core/repos-index.d.ts

@@ -0,0 +1,113 @@
+/**
+ * grf 仓库索引管理模块
+ * 管理仓库列表，存储在独立的 repos.json 文件中
+ */
+import { RepoEntry } from "../types";
+/**
+ * 仓库配置类型（RepoEntry 的别名）
+ * 用于保持 API 一致性
+ */
+export type RepoConfig = RepoEntry;
+/**
+ * 仓库索引文件结构
+ */
+export interface ReposIndex {
+    repos: Record<string, RepoConfig>;
+}
+/**
+ * 仓库索引管理器
+ * 管理 repos.json 文件中的仓库列表
+ */
+export declare class ReposIndexManager {
+    private cache;
+    /**
+     * 读取仓库索引文件
+     * 如果文件不存在，返回空的仓库索引
+     * @returns 仓库索引对象
+     */
+    private read;
+    /**
+     * 写入仓库索引文件
+     * @param index 要写入的仓库索引
+     */
+    private write;
+    /**
+     * 获取所有仓库
+     * @returns 仓库名称到配置的映射
+     */
+    getAll(): Promise<Record<string, RepoConfig>>;
+    /**
+     * 获取单个仓库
+     * @param name 仓库名称
+     * @returns 仓库配置，如果不存在则返回 undefined
+     */
+    get(name: string): Promise<RepoConfig | undefined>;
+    /**
+     * 添加或更新仓库
+     * @param name 仓库名称
+     * @param config 仓库配置
+     */
+    set(name: string, config: RepoConfig): Promise<void>;
+    /**
+     * 删除仓库
+     * @param name 仓库名称
+     * @returns 是否成功删除（仓库存在则返回 true）
+     */
+    remove(name: string): Promise<boolean>;
+    /**
+     * 检查仓库是否存在
+     * @param name 仓库名称
+     * @returns 仓库是否存在
+     */
+    has(name: string): Promise<boolean>;
+    /**
+     * 获取仓库数量
+     * @returns 仓库数量
+     */
+    count(): Promise<number>;
+    /**
+     * 获取所有仓库名称
+     * @returns 仓库名称数组
+     */
+    names(): Promise<string[]>;
+    /**
+     * 清空所有仓库
+     */
+    clear(): Promise<void>;
+    /**
+     * 批量设置仓库（用于迁移）
+     * @param repos 仓库名称到配置的映射
+     */
+    setAll(repos: Record<string, RepoConfig>): Promise<void>;
+    /**
+     * 清除缓存
+     * 下次调用读取方法时会重新从文件读取
+     */
+    clearCache(): void;
+}
+/** 仓库索引管理器单例 */
+export declare const reposIndex: ReposIndexManager;
+/**
+ * 获取所有仓库配置
+ * @returns 仓库名称到配置的映射
+ */
+export declare function getAllRepos(): Promise<Record<string, RepoConfig>>;
+/**
+ * 获取单个仓库配置
+ * @param name 仓库名称
+ * @returns 仓库配置，如果不存在则返回 undefined
+ */
+export declare function getRepo(name: string): Promise<RepoConfig | undefined>;
+/**
+ * 保存仓库配置
+ * @param name 仓库名称
+ * @param config 仓库配置
+ */
+export declare function saveRepo(name: string, config: RepoConfig): Promise<void>;
+/**
+ * 删除仓库配置
+ * @param name 仓库名称
+ * @returns 是否成功删除
+ */
+export declare function removeRepo(name: string): Promise<boolean>;
+//# sourceMappingURL=repos-index.d.ts.map

package/dist/core/repos-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repos-index.d.ts","sourceRoot":"","sources":["../../src/core/repos-index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAMrC;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACnC;AAMD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA2B;IAExC;;;;OAIG;YACW,IAAI;IAqClB;;;OAGG;YACW,KAAK;IAanB;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAKnD;;;;OAIG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAKxD;;;;OAIG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY5C;;;;OAIG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKzC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAK9B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKhC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D;;;OAGG;IACH,UAAU,IAAI,IAAI;CAGnB;AAMD,gBAAgB;AAChB,eAAO,MAAM,UAAU,mBAA0B,CAAC;AAMlD;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAEvE;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAE3E;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/D"}