@optima-chat/commerce-cli 1.9.5 → 1.10.0

package/dist/commands/collection/set-cover.js

@@ -0,0 +1,158 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { commerceApi } from '../../api/rest/commerce.js';
+import { handleError, createApiError, ValidationError } from '../../utils/error.js';
+import { formatFileSize } from '../../utils/format.js';
+import { existsSync, statSync } from 'fs';
+import { output } from '../../utils/output.js';
+import { addEnhancedHelp } from '../../utils/helpText.js';
+const cmd = new Command('set-cover')
+    .description('Set collection cover image')
+    .option('--id <uuid>', 'Collection ID (required)')
+    .option('--media-id <id>', 'Media ID from upload command (recommended)')
+    .option('--url <url>', 'Image URL')
+    .option('--path <path>', 'Local image file path')
+    .action(async (options) => {
+    try {
+        await setCover(options);
+    }
+    catch (error) {
+        handleError(error);
+    }
+});
+addEnhancedHelp(cmd, {
+    examples: [
+        '# Use media ID (recommended, reuse uploaded images)',
+        '$ commerce upload image --path ./cover.jpg',
+        '# Copy media_id from response',
+        '$ commerce collection set-cover --id coll-123 --media-id media_456',
+        '',
+        '# Use image URL',
+        '$ commerce collection set-cover --id coll-123 --url "https://example.com/cover.jpg"',
+        '',
+        '# Upload local file directly',
+        '$ commerce collection set-cover --id coll-123 --path ./cover.jpg',
+    ],
+    output: {
+        example: JSON.stringify({
+            success: true,
+            data: {
+                id: 'coll-123',
+                name: 'Summer Sale',
+                image_url: 'https://cdn.optima.shop/uploads/xxx.jpg'
+            },
+            message: '集合封面设置成功'
+        }, null, 2)
+    },
+    relatedCommands: [
+        { command: 'upload image', description: 'Upload image to get media ID' },
+        { command: 'collection create', description: 'Create collection with cover image' },
+        { command: 'collection update', description: 'Update collection (alternative way)' },
+    ],
+    notes: [
+        'Collection ID is required',
+        'Provide one of: --media-id, --url, or --path',
+        'Using --media-id is recommended (upload first, then associate)',
+        'Supported formats: JPG, PNG, GIF, WebP',
+        'Maximum file size: 10MB',
+    ]
+});
+export const setCoverCommand = cmd;
+async function setCover(options) {
+    const { id, mediaId, url, path } = options;
+    // 1. 验证必需参数
+    if (!id || id.trim().length === 0) {
+        throw new ValidationError('集合 ID 不能为空', 'id');
+    }
+    if (!mediaId && !url && !path) {
+        throw new ValidationError('请提供图片来源（--media-id、--url 或 --path）', 'image');
+    }
+    const collectionId = id.trim();
+    const updateData = {};
+    // 2. 根据输入方式处理
+    if (mediaId) {
+        // 方式 1：使用 Media ID（推荐）
+        if (!output.isJson()) {
+            console.log(chalk.cyan('\n🖼️  设置集合封面...\n'));
+            console.log(chalk.green(`✓ Media ID: ${mediaId}`));
+            console.log();
+        }
+        updateData.cover_media_id = mediaId.trim();
+    }
+    else if (url) {
+        // 方式 2：使用 URL
+        if (!output.isJson()) {
+            console.log(chalk.cyan('\n🖼️  设置集合封面...\n'));
+            console.log(chalk.green(`✓ URL: ${url}`));
+            console.log();
+        }
+        updateData.image_url = url.trim();
+    }
+    else if (path) {
+        // 方式 3：上传本地文件
+        if (!output.isJson()) {
+            console.log(chalk.cyan('\n🖼️  设置集合封面...\n'));
+        }
+        // 验证文件存在
+        if (!existsSync(path)) {
+            throw new ValidationError(`文件不存在: ${path}`, 'path');
+        }
+        const stats = statSync(path);
+        const fileSize = stats.size;
+        // 检查文件大小（限制 10MB）
+        if (fileSize > 10 * 1024 * 1024) {
+            throw new ValidationError(`文件过大 (${formatFileSize(fileSize)})，最大支持 10MB`, 'path');
+        }
+        // 检查文件扩展名
+        const ext = path.toLowerCase().split('.').pop();
+        if (!['jpg', 'jpeg', 'png', 'gif', 'webp'].includes(ext || '')) {
+            throw new ValidationError(`不支持的图片格式: ${ext}，支持 JPG, PNG, GIF, WebP`, 'path');
+        }
+        if (!output.isJson()) {
+            console.log(chalk.green(`✓ 文件: ${path} (${formatFileSize(fileSize)})`));
+            console.log();
+        }
+        // 上传文件
+        const uploadSpinner = output.spinner('正在上传图片...');
+        try {
+            const uploaded = await commerceApi.upload.uploadImage(path);
+            uploadSpinner.succeed('图片上传成功');
+            if (uploaded.media_id) {
+                updateData.cover_media_id = uploaded.media_id;
+            }
+            else {
+                // fallback to URL if no media_id returned
+                updateData.image_url = uploaded.url;
+            }
+        }
+        catch (error) {
+            uploadSpinner.fail('图片上传失败');
+            throw createApiError(error);
+        }
+    }
+    // 3. 更新集合封面
+    const updateSpinner = output.spinner('正在设置封面...');
+    try {
+        const collection = await commerceApi.collections.update(collectionId, updateData);
+        updateSpinner.succeed('集合封面设置成功！');
+        if (output.isJson()) {
+            output.success(collection, '集合封面设置成功');
+        }
+        else {
+            console.log();
+            console.log(chalk.green('✓ 集合封面设置成功！'));
+            console.log();
+            console.log(chalk.gray('ID: ') + chalk.cyan(collection.id));
+            console.log(chalk.gray('名称: ') + chalk.white(collection.name));
+            if (collection.image_url) {
+                console.log(chalk.gray('封面: ') + chalk.white(collection.image_url));
+            }
+            console.log();
+        }
+    }
+    catch (error) {
+        updateSpinner.fail('设置封面失败');
+        throw createApiError(error);
+    }
+}
+//# sourceMappingURL=set-cover.js.map

package/dist/commands/collection/set-cover.js.map

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