@uofx/cli 1.0.1 → 1.1.0

package/dist/infrastructure/template/services/template-downloader.service.js

@@ -0,0 +1,319 @@
+"use strict";
+/**
+ * Template Downloader
+ *
+ * 負責從遠端下載樣板 ZIP 並解壓縮
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateDownloader = void 0;
+const tsyringe_1 = require("tsyringe");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const https = __importStar(require("https"));
+const http = __importStar(require("http"));
+const adm_zip_1 = __importDefault(require("adm-zip"));
+const tokens_1 = require("../../../di/tokens");
+const errors_1 = require("../../../domain/errors");
+let TemplateDownloader = class TemplateDownloader {
+    constructor(logger) {
+        this.logger = logger;
+    }
+    async downloadAndExtract(url, destDir, templateName) {
+        // 驗證 URL 必須為 https:// 協議，防止 file:// 等危險協議
+        this.validateUrl(url);
+        const tempZipPath = path.join(destDir, `${templateName}.zip`);
+        try {
+            this.logger.debug(`Downloading template from ${url}`);
+            // 確保目標目錄存在
+            if (!fs.existsSync(destDir)) {
+                fs.mkdirSync(destDir, { recursive: true });
+            }
+            // 下載 ZIP 檔案
+            await this.downloadFile(url, tempZipPath);
+            // 解壓縮
+            const result = await this.extractFromLocal(tempZipPath, destDir, templateName);
+            // 刪除暫存 ZIP
+            if (fs.existsSync(tempZipPath)) {
+                fs.unlinkSync(tempZipPath);
+            }
+            return result;
+        }
+        catch (error) {
+            // 清理暫存檔案
+            if (fs.existsSync(tempZipPath)) {
+                fs.unlinkSync(tempZipPath);
+            }
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(new Error(`Failed to download template: ${errorMessage}`));
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+    }
+    async extractFromLocal(zipPath, destDir, templateName) {
+        try {
+            if (!fs.existsSync(zipPath)) {
+                return {
+                    success: false,
+                    error: `ZIP file not found: ${zipPath}`,
+                };
+            }
+            const extractPath = path.join(destDir, templateName);
+            // 如果目標目錄已存在，先刪除
+            if (fs.existsSync(extractPath)) {
+                fs.rmSync(extractPath, { recursive: true, force: true });
+            }
+            this.logger.debug(`Extracting template to ${extractPath}`);
+            const zip = new adm_zip_1.default(zipPath);
+            // ZIP Slip 防護：檢查所有 entry 路徑是否逃逸出目標目錄
+            const resolvedExtractPath = path.resolve(extractPath);
+            for (const entry of zip.getEntries()) {
+                const entryPath = path.resolve(extractPath, entry.entryName);
+                if (!entryPath.startsWith(resolvedExtractPath + path.sep) && entryPath !== resolvedExtractPath) {
+                    throw new errors_1.AppError(`ZIP entry "${entry.entryName}" attempts to escape extraction directory (ZIP Slip attack)`, { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
+                }
+            }
+            zip.extractAllTo(extractPath, true);
+            // 處理 ZIP 內可能有單一根目錄的情況
+            const extractedContents = fs.readdirSync(extractPath);
+            if (extractedContents.length === 1) {
+                const innerDir = path.join(extractPath, extractedContents[0]);
+                if (fs.statSync(innerDir).isDirectory()) {
+                    // 將內層目錄的內容移到外層
+                    const innerContents = fs.readdirSync(innerDir);
+                    for (const item of innerContents) {
+                        const srcPath = path.join(innerDir, item);
+                        const destPath = path.join(extractPath, item);
+                        fs.renameSync(srcPath, destPath);
+                    }
+                    fs.rmdirSync(innerDir);
+                }
+            }
+            // 建立 project 目錄並移動檔案
+            const projectDir = path.join(extractPath, 'project');
+            fs.mkdirSync(projectDir, { recursive: true });
+            // 將解壓的內容（除了 template.json 和 project 本身）移到 project/
+            const contentsToMove = fs.readdirSync(extractPath);
+            for (const item of contentsToMove) {
+                if (item === 'project' || item === 'template.json')
+                    continue;
+                const srcPath = path.join(extractPath, item);
+                const destPath = path.join(projectDir, item);
+                fs.renameSync(srcPath, destPath);
+            }
+            this.logger.debug(`Template extracted successfully to ${extractPath}`);
+            return {
+                success: true,
+                extractedPath: extractPath,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(new Error(`Failed to extract template: ${errorMessage}`));
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+    }
+    async getGitHubArchiveUrl(repo, version) {
+        try {
+            let tag = version;
+            // 若未指定版本，取得最新的 tag
+            if (!tag) {
+                this.logger.debug('Getting latest tag from GitHub...');
+                const apiUrl = `https://api.github.com/repos/${repo}/tags`;
+                const tags = await this.fetchJson(apiUrl);
+                if (!tags || tags.length === 0) {
+                    throw new errors_1.AppError(`No tags found in repository ${repo}`, {
+                        exitCode: errors_1.EXIT_CODES.NETWORK_ERROR,
+                    });
+                }
+                tag = tags[0].name;
+                this.logger.debug(`Latest tag: ${tag}`);
+            }
+            // 組合 source archive URL
+            // 格式: https://github.com/{owner}/{repo}/archive/refs/tags/{tag}.zip
+            const archiveUrl = `https://github.com/${repo}/archive/refs/tags/${tag}.zip`;
+            return {
+                url: archiveUrl,
+                tag: tag,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new errors_1.AppError(`Failed to get GitHub archive URL: ${errorMessage}`, {
+                exitCode: errors_1.EXIT_CODES.NETWORK_ERROR,
+            });
+        }
+    }
+    /**
+     * 驗證 URL 必須使用安全協議
+     * @param url - 要驗證的 URL
+     * @throws 若 URL 非 https:// 協議
+     */
+    validateUrl(url) {
+        try {
+            const parsedUrl = new URL(url);
+            if (parsedUrl.protocol !== 'https:') {
+                throw new errors_1.AppError(`Unsupported URL protocol: "${parsedUrl.protocol}". Only HTTPS is allowed.`, { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
+            }
+        }
+        catch (error) {
+            if (error instanceof errors_1.AppError)
+                throw error;
+            throw new errors_1.AppError(`Invalid URL format: "${url}"`, { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
+        }
+    }
+    /**
+     * 下載檔案
+     */
+    downloadFile(url, destPath) {
+        return new Promise((resolve, reject) => {
+            const protocol = url.startsWith('https') ? https : http;
+            const file = fs.createWriteStream(destPath);
+            const request = protocol.get(url, { headers: { 'User-Agent': 'uofx-cli' } }, (response) => {
+                // 處理重定向
+                // 處理重定向
+                if (response.statusCode === 301 || response.statusCode === 302) {
+                    const redirectUrl = response.headers.location;
+                    if (redirectUrl) {
+                        request.destroy();
+                        file.close();
+                        fs.unlinkSync(destPath);
+                        this.downloadFile(redirectUrl, destPath).then(resolve).catch(reject);
+                        return;
+                    }
+                }
+                if (response.statusCode !== 200) {
+                    request.destroy();
+                    file.close();
+                    fs.unlinkSync(destPath);
+                    reject(new errors_1.AppError(`HTTP ${response.statusCode}: ${response.statusMessage}`, {
+                        exitCode: errors_1.EXIT_CODES.NETWORK_ERROR,
+                    }));
+                    return;
+                }
+                response.pipe(file);
+                file.on('finish', () => {
+                    request.destroy();
+                    file.close();
+                    resolve();
+                });
+            });
+            request.on('error', (error) => {
+                request.destroy();
+                file.close();
+                if (fs.existsSync(destPath)) {
+                    fs.unlinkSync(destPath);
+                }
+                reject(error);
+            });
+            file.on('error', (error) => {
+                request.destroy();
+                file.close();
+                if (fs.existsSync(destPath)) {
+                    fs.unlinkSync(destPath);
+                }
+                reject(error);
+            });
+        });
+    }
+    /**
+     * 取得 JSON 回應
+     */
+    fetchJson(url) {
+        return new Promise((resolve, reject) => {
+            const protocol = url.startsWith('https') ? https : http;
+            const request = protocol.get(url, {
+                headers: {
+                    'User-Agent': 'uofx-cli',
+                    Accept: 'application/vnd.github.v3+json',
+                },
+            }, (response) => {
+                if (response.statusCode !== 200) {
+                    request.destroy();
+                    reject(new errors_1.AppError(`HTTP ${response.statusCode}: ${response.statusMessage}`, {
+                        exitCode: errors_1.EXIT_CODES.NETWORK_ERROR,
+                    }));
+                    return;
+                }
+                let data = '';
+                response.on('data', (chunk) => {
+                    data += chunk;
+                });
+                response.on('end', () => {
+                    request.destroy();
+                    try {
+                        resolve(JSON.parse(data));
+                    }
+                    catch (error) {
+                        reject(new errors_1.AppError('Failed to parse JSON response', {
+                            exitCode: errors_1.EXIT_CODES.NETWORK_ERROR,
+                        }));
+                    }
+                });
+            });
+            request.on('error', (error) => {
+                request.destroy();
+                reject(error);
+            });
+        });
+    }
+};
+exports.TemplateDownloader = TemplateDownloader;
+exports.TemplateDownloader = TemplateDownloader = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.ILoggerPort)),
+    __metadata("design:paramtypes", [Object])
+], TemplateDownloader);
+//# sourceMappingURL=template-downloader.service.js.map

package/dist/infrastructure/template/services/template-registry.service.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * Template Registry
+ *
+ * 負責管理已安裝樣板的註冊表
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateRegistry = void 0;
+const tsyringe_1 = require("tsyringe");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const tokens_1 = require("../../../di/tokens");
+const template_info_entity_1 = require("../../../domain/entities/template-info.entity");
+let TemplateRegistry = class TemplateRegistry {
+    constructor(logger, appConfig) {
+        this.logger = logger;
+        this.appConfig = appConfig;
+        this.registryFileName = 'templates.json';
+        this.templatesCache = new Map();
+        this.registryData = { version: '1.0.0', templates: [] };
+        this.load();
+    }
+    getAll() {
+        return Array.from(this.templatesCache.values());
+    }
+    get(name) {
+        return this.templatesCache.get(name);
+    }
+    register(templatePath, name, version, sourceUrl) {
+        const templateInfo = template_info_entity_1.TemplateInfo.create(name, version, new Date(), templatePath, sourceUrl);
+        // 更新註冊表
+        const existingIndex = this.registryData.templates.findIndex((t) => t.name === templateInfo.name);
+        const entry = {
+            name: templateInfo.name,
+            version: templateInfo.version,
+            installedAt: new Date().toISOString(),
+            path: templatePath,
+            sourceUrl,
+        };
+        if (existingIndex >= 0) {
+            this.registryData.templates[existingIndex] = entry;
+        }
+        else {
+            this.registryData.templates.push(entry);
+        }
+        // 更新快取
+        this.templatesCache.set(templateInfo.name, templateInfo);
+        // 儲存註冊表
+        this.save();
+        this.logger.debug(`Template "${templateInfo.name}" registered at ${templatePath}`);
+        return templateInfo;
+    }
+    unregister(name) {
+        const index = this.registryData.templates.findIndex((t) => t.name === name);
+        if (index < 0) {
+            return false;
+        }
+        this.registryData.templates.splice(index, 1);
+        this.templatesCache.delete(name);
+        this.save();
+        this.logger.debug(`Template "${name}" unregistered`);
+        return true;
+    }
+    isRegistered(name) {
+        return this.templatesCache.has(name);
+    }
+    getTemplateCacheDir() {
+        const userConfigDir = this.appConfig.getUserConfigDir();
+        return path.join(userConfigDir, 'templates');
+    }
+    save() {
+        const registryPath = this.getRegistryPath();
+        const dir = path.dirname(registryPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(registryPath, JSON.stringify(this.registryData, null, 2), 'utf-8');
+    }
+    reload() {
+        this.load();
+    }
+    /**
+     * 取得註冊表檔案路徑
+     */
+    getRegistryPath() {
+        return path.join(this.getTemplateCacheDir(), this.registryFileName);
+    }
+    /**
+     * 載入註冊表
+     */
+    load() {
+        const registryPath = this.getRegistryPath();
+        if (!fs.existsSync(registryPath)) {
+            this.registryData = { version: '1.0.0', templates: [] };
+            this.templatesCache.clear();
+            return;
+        }
+        try {
+            this.registryData = JSON.parse(fs.readFileSync(registryPath, 'utf-8'));
+            this.templatesCache.clear();
+            // 從註冊表項目直接建立 TemplateInfo
+            for (const entry of this.registryData.templates) {
+                try {
+                    if (!fs.existsSync(entry.path)) {
+                        this.logger.warn(`Template "${entry.name}" not found at ${entry.path}, skipping`);
+                        continue;
+                    }
+                    const templateInfo = template_info_entity_1.TemplateInfo.create(entry.name, entry.version, new Date(entry.installedAt), entry.path, entry.sourceUrl);
+                    this.templatesCache.set(templateInfo.name, templateInfo);
+                }
+                catch (error) {
+                    this.logger.warn(`Failed to load template "${entry.name}": ${error}`);
+                }
+            }
+        }
+        catch (error) {
+            this.logger.error(new Error(`Failed to load template registry: ${error}`));
+            this.registryData = { version: '1.0.0', templates: [] };
+            this.templatesCache.clear();
+        }
+    }
+};
+exports.TemplateRegistry = TemplateRegistry;
+exports.TemplateRegistry = TemplateRegistry = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.ILoggerPort)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.IAppConfigPort)),
+    __metadata("design:paramtypes", [Object, Object])
+], TemplateRegistry);
+//# sourceMappingURL=template-registry.service.js.map

package/dist/infrastructure/template/template-manager.adapter.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * Template Manager Adapter
+ *
+ * 實作 ITemplateManagerPort 介面
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateManagerAdapter = void 0;
+const tsyringe_1 = require("tsyringe");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const tokens_1 = require("../../di/tokens");
+/**
+ * 包含 sample 程式碼的樣板 repo（預設）
+ */
+const TEMPLATE_REPO_WITH_SAMPLE = 'UOfficeForceX/UOFX-Plugin-Training';
+/**
+ * 不含 sample 程式碼的基礎樣板 repo
+ */
+const TEMPLATE_REPO_BASE = 'UOfficeForceX/UOFX-Plugin-Base';
+let TemplateManagerAdapter = class TemplateManagerAdapter {
+    constructor(logger, downloader, registry) {
+        this.logger = logger;
+        this.downloader = downloader;
+        this.registry = registry;
+    }
+    async install(options, output) {
+        try {
+            const cacheDir = this.registry.getTemplateCacheDir();
+            // 確保快取目錄存在
+            if (!fs.existsSync(cacheDir)) {
+                fs.mkdirSync(cacheDir, { recursive: true });
+            }
+            let downloadUrl;
+            let templateName;
+            let versionTag; // 儲存實際版本號（供 registry 使用）
+            // [Step 1] Resolving template version
+            output?.section('[1/4] Resolving template version').flush();
+            if (options.url) {
+                output?.item('arrow', 'Using custom URL...').flush();
+                downloadUrl = options.url;
+                templateName = options.name || 'custom';
+                versionTag = templateName;
+            }
+            else {
+                output?.item('arrow', 'Fetching latest version from GitHub...').flush();
+                this.logger.debug('Getting archive URL from GitHub...');
+                const repo = (options.withSample ?? true) ? TEMPLATE_REPO_WITH_SAMPLE : TEMPLATE_REPO_BASE;
+                const archiveResult = await this.downloader.getGitHubArchiveUrl(repo);
+                downloadUrl = archiveResult.url;
+                templateName = options.name || archiveResult.tag; // 優先使用 options.name（Bug 修正）
+                versionTag = archiveResult.tag; // 版本號始終來自 tag
+            }
+            output?.success(`Using version: ${templateName}`).flush();
+            // 檢查是否已安裝
+            if (this.registry.isRegistered(templateName)) {
+                const existingTemplate = this.registry.get(templateName);
+                return {
+                    success: false,
+                    template: existingTemplate,
+                    message: `Template "${templateName}" is already installed.`,
+                };
+            }
+            // [Step 2] Downloading template
+            output?.newline().section('[2/4] Downloading template').flush();
+            output?.item('arrow', `Downloading from: ${downloadUrl}`).flush();
+            this.logger.debug(`Downloading template from ${downloadUrl}`);
+            // [Step 3] Extracting template
+            output?.newline().section('[3/4] Extracting template').flush();
+            output
+                ?.item('arrow', `Extracting to: ${path.join(cacheDir, templateName)}`)
+                .flush();
+            // 下載並解壓縮
+            const result = await this.downloader.downloadAndExtract(downloadUrl, cacheDir, templateName);
+            if (!result.success || !result.extractedPath) {
+                return {
+                    success: false,
+                    message: result.error || 'Failed to download template',
+                };
+            }
+            output?.item('arrow', 'Creating project directory structure...').flush();
+            output?.success('Template extracted').flush();
+            // [Step 4] Registering template
+            output?.newline().section('[4/4] Registering template').flush();
+            output?.item('arrow', 'Updating template registry...').flush();
+            // 註冊樣板
+            const version = versionTag.replace(/^v/, ''); // 去掉 v 前綴
+            const templateInfo = this.registry.register(result.extractedPath, templateName, version, downloadUrl);
+            output?.success('Template registered').flush();
+            return {
+                success: true,
+                template: templateInfo,
+                message: `Template "${templateInfo.name}" installed successfully.`,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(new Error(`Failed to install template: ${errorMessage}`));
+            return {
+                success: false,
+                message: errorMessage,
+            };
+        }
+    }
+    async list() {
+        return this.registry.getAll();
+    }
+    async get(name) {
+        return this.registry.get(name);
+    }
+    async uninstall(name) {
+        const template = this.registry.get(name);
+        if (!template) {
+            this.logger.warn(`Template "${name}" is not installed`);
+            return false;
+        }
+        try {
+            // 刪除樣板目錄
+            if (fs.existsSync(template.path)) {
+                fs.rmSync(template.path, { recursive: true, force: true });
+            }
+            // 從註冊表移除
+            this.registry.unregister(name);
+            this.logger.debug(`Template "${name}" uninstalled successfully`);
+            return true;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(new Error(`Failed to uninstall template: ${errorMessage}`));
+            return false;
+        }
+    }
+    async isInstalled(name) {
+        return this.registry.isRegistered(name);
+    }
+    getTemplateCacheDir() {
+        return this.registry.getTemplateCacheDir();
+    }
+    getTemplatePath(name) {
+        return path.join(this.getTemplateCacheDir(), name);
+    }
+};
+exports.TemplateManagerAdapter = TemplateManagerAdapter;
+exports.TemplateManagerAdapter = TemplateManagerAdapter = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.ILoggerPort)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.TemplateDownloader)),
+    __param(2, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.TemplateRegistry)),
+    __metadata("design:paramtypes", [Object, Object, Object])
+], TemplateManagerAdapter);
+//# sourceMappingURL=template-manager.adapter.js.map