@optima-chat/commerce-cli 1.0.0

package/dist/commands/order/get.js.map

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

package/dist/commands/order/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const orderCommand: Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/order/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/order/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,eAAO,MAAM,YAAY,SAOU,CAAC"}

package/dist/commands/order/index.js

@@ -0,0 +1,16 @@
+import { Command } from 'commander';
+import { listOrdersCommand } from './list.js';
+import { getOrderCommand } from './get.js';
+import { shipOrderCommand } from './ship.js';
+import { completeOrderCommand } from './complete.js';
+import { cancelOrderCommand } from './cancel.js';
+import { markDeliveredCommand } from './mark-delivered.js';
+export const orderCommand = new Command('order')
+    .description('订单管理')
+    .addCommand(listOrdersCommand)
+    .addCommand(getOrderCommand)
+    .addCommand(shipOrderCommand)
+    .addCommand(completeOrderCommand)
+    .addCommand(cancelOrderCommand)
+    .addCommand(markDeliveredCommand);
+//# sourceMappingURL=index.js.map

package/dist/commands/order/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/order/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,MAAM,CAAC;KACnB,UAAU,CAAC,iBAAiB,CAAC;KAC7B,UAAU,CAAC,eAAe,CAAC;KAC3B,UAAU,CAAC,gBAAgB,CAAC;KAC5B,UAAU,CAAC,oBAAoB,CAAC;KAChC,UAAU,CAAC,kBAAkB,CAAC;KAC9B,UAAU,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/commands/order/list.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const listOrdersCommand: Command;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/order/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/order/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmFpC,eAAO,MAAM,iBAAiB,SAAM,CAAC"}

package/dist/commands/order/list.js

@@ -0,0 +1,135 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { commerceApi } from '../../api/rest/commerce.js';
+import { handleError, createApiError } from '../../utils/error.js';
+import { formatOrderList } from '../../utils/format.js';
+import { output } from '../../utils/output.js';
+import { addEnhancedHelp } from '../../utils/helpText.js';
+const cmd = new Command('list')
+    .description('List orders with pagination and filtering options')
+    .option('-l, --limit <number>', 'Orders per page (default: 20)', '20')
+    .option('-o, --offset <number>', 'Offset for pagination (default: 0)', '0')
+    .option('-s, --status <string>', 'Filter by status: pending|paid|processing|shipped|delivered|completed|cancelled|refunded')
+    .option('--start-date <date>', 'Start date (YYYY-MM-DD)')
+    .option('--end-date <date>', 'End date (YYYY-MM-DD)')
+    .action(async (options) => {
+    try {
+        await listOrders(options);
+    }
+    catch (error) {
+        handleError(error);
+    }
+});
+addEnhancedHelp(cmd, {
+    examples: [
+        '# List all orders (first 20)',
+        '$ commerce order list',
+        '',
+        '# Filter by status to find orders to ship',
+        '$ commerce order list --status paid',
+        '',
+        '# List recent orders with date range',
+        '$ commerce order list --start-date 2024-01-01 --end-date 2024-01-31',
+        '',
+        '# Combine filters',
+        '$ commerce order list --status shipped --limit 50 --json',
+    ],
+    output: {
+        example: JSON.stringify({
+            success: true,
+            data: {
+                orders: [
+                    {
+                        order_id: 'uuid',
+                        order_number: 'ORD-001',
+                        status: 'paid',
+                        total: '99.99',
+                        currency: 'USD',
+                        customer_email: 'customer@example.com',
+                        created_at: 'timestamp',
+                    },
+                ],
+                total: 42,
+                page: 1,
+                per_page: 20,
+                has_next: true,
+            },
+        }, null, 2),
+    },
+    relatedCommands: [
+        { command: 'order get', description: 'View full order details' },
+        { command: 'order ship', description: 'Ship paid orders' },
+        { command: 'order complete', description: 'Mark orders as completed' },
+    ],
+    notes: [
+        'Status workflow: pending → paid → processing → shipped → delivered → completed',
+        'Use --status paid to find orders ready to ship',
+        'Date range is inclusive (includes both start and end dates)',
+    ],
+});
+export const listOrdersCommand = cmd;
+async function listOrders(options) {
+    const spinner = output.spinner('正在获取订单列表...');
+    try {
+        const params = {
+            limit: parseInt(options.limit || '20', 10),
+            offset: parseInt(options.offset || '0', 10),
+        };
+        if (options.status) {
+            params.status = options.status;
+        }
+        if (options.startDate) {
+            params.start_date = options.startDate;
+        }
+        if (options.endDate) {
+            params.end_date = options.endDate;
+        }
+        const result = await commerceApi.orders.list(params);
+        spinner.succeed('订单列表获取成功');
+        if (!result.orders || result.orders.length === 0) {
+            if (output.isJson()) {
+                output.success({
+                    orders: [],
+                    total: 0,
+                    page: Math.floor(params.offset / params.limit) + 1,
+                    per_page: params.limit,
+                    has_next: false
+                }, '暂无订单');
+            }
+            else {
+                console.log(chalk.yellow('\n暂无订单\n'));
+            }
+            return;
+        }
+        if (output.isJson()) {
+            // JSON 模式：输出结构化数据
+            output.success({
+                orders: result.orders,
+                total: result.total,
+                page: Math.floor(params.offset / params.limit) + 1,
+                per_page: params.limit,
+                offset: params.offset,
+                has_next: result.total > (params.offset + params.limit)
+            });
+        }
+        else {
+            // Pretty 模式：保持原有表格输出
+            console.log();
+            console.log(formatOrderList(result.orders));
+            // 显示分页信息
+            console.log(chalk.gray(`\n显示 ${params.offset + 1}-${Math.min(params.offset + params.limit, result.total)} / 共 ${result.total} 个订单`));
+            // 提示翻页
+            if (result.total > params.offset + params.limit) {
+                const nextOffset = params.offset + params.limit;
+                console.log(chalk.gray(`下一页: `) +
+                    chalk.cyan(`commerce order list --limit ${params.limit} --offset ${nextOffset}`));
+            }
+            console.log();
+        }
+    }
+    catch (error) {
+        spinner.fail('获取订单列表失败');
+        throw createApiError(error);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/order/list.js.map

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

package/dist/commands/order/mark-delivered.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const markDeliveredCommand: Command;
+//# sourceMappingURL=mark-delivered.d.ts.map

package/dist/commands/order/mark-delivered.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-delivered.d.ts","sourceRoot":"","sources":["../../../src/commands/order/mark-delivered.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6CpC,eAAO,MAAM,oBAAoB,SAAM,CAAC"}

package/dist/commands/order/mark-delivered.js

@@ -0,0 +1,70 @@
+import { Command } from 'commander';
+import { commerceApi } from '../../api/rest/commerce.js';
+import { handleError, createApiError, ValidationError } from '../../utils/error.js';
+import { formatOrder } from '../../utils/format.js';
+import { output } from '../../utils/output.js';
+import { addEnhancedHelp } from '../../utils/helpText.js';
+const cmd = new Command('mark-delivered')
+    .description('Mark order as delivered to customer')
+    .option('--id <uuid>', 'Order ID (required)')
+    .action(async (options) => {
+    try {
+        await markDelivered(options);
+    }
+    catch (error) {
+        handleError(error);
+    }
+});
+addEnhancedHelp(cmd, {
+    examples: [
+        '# Mark order as delivered',
+        '$ commerce order mark-delivered --id order-123',
+    ],
+    output: {
+        example: JSON.stringify({
+            success: true,
+            data: {
+                order_id: 'uuid',
+                status: 'delivered'
+            }
+        }, null, 2)
+    },
+    relatedCommands: [
+        { command: 'order ship', description: 'Ship order first' },
+        { command: 'shipping update-status', description: 'Update tracking status' },
+        { command: 'order complete', description: 'Complete after delivery' },
+    ],
+    notes: [
+        'Order ID is required',
+        'Order must be shipped before marking as delivered',
+        'Updates order status to delivered',
+        'Use after confirming customer received package',
+    ]
+});
+export const markDeliveredCommand = cmd;
+async function markDelivered(options) {
+    if (!options.id || options.id.trim().length === 0) {
+        throw new ValidationError('订单 ID 不能为空', 'id');
+    }
+    const orderId = options.id;
+    const spinner = output.spinner('正在标记订单已送达...');
+    try {
+        const order = await commerceApi.orders.markDelivered(orderId);
+        spinner.succeed('订单已标记为送达！');
+        if (output.isJson()) {
+            output.success({
+                order_id: order.id || order.order_id,
+                status: order.status
+            });
+        }
+        else {
+            console.log();
+            console.log(formatOrder(order));
+        }
+    }
+    catch (error) {
+        spinner.fail('标记订单失败');
+        throw createApiError(error);
+    }
+}
+//# sourceMappingURL=mark-delivered.js.map

package/dist/commands/order/mark-delivered.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-delivered.js","sourceRoot":"","sources":["../../../src/commands/order/mark-delivered.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC;KACtC,WAAW,CAAC,qCAAqC,CAAC;KAClD,MAAM,CAAC,aAAa,EAAE,qBAAqB,CAAC;KAC5C,MAAM,CAAC,KAAK,EAAE,OAAwB,EAAE,EAAE;IACzC,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,eAAe,CAAC,GAAG,EAAE;IACnB,QAAQ,EAAE;QACR,2BAA2B;QAC3B,gDAAgD;KACjD;IACD,MAAM,EAAE;QACN,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;YACtB,OAAO,EAAE,IAAI;YACb,IAAI,EAAE;gBACJ,QAAQ,EAAE,MAAM;gBAChB,MAAM,EAAE,WAAW;aACpB;SACF,EAAE,IAAI,EAAE,CAAC,CAAC;KACZ;IACD,eAAe,EAAE;QACf,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE;QAC1D,EAAE,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,wBAAwB,EAAE;QAC5E,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,yBAAyB,EAAE;KACtE;IACD,KAAK,EAAE;QACL,sBAAsB;QACtB,mDAAmD;QACnD,mCAAmC;QACnC,gDAAgD;KACjD;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC,KAAK,UAAU,aAAa,CAAC,OAAwB;IACnD,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC;IAE3B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9D,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAE7B,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACpB,MAAM,CAAC,OAAO,CAAC;gBACb,QAAQ,EAAE,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,QAAQ;gBACpC,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/commands/order/ship.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const shipOrderCommand: Command;
+//# sourceMappingURL=ship.d.ts.map

package/dist/commands/order/ship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.d.ts","sourceRoot":"","sources":["../../../src/commands/order/ship.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkEpC,eAAO,MAAM,gBAAgB,SAAM,CAAC"}

package/dist/commands/order/ship.js

@@ -0,0 +1,124 @@
+import { Command } from 'commander';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { commerceApi } from '../../api/rest/commerce.js';
+import { handleError, createApiError, ValidationError } from '../../utils/error.js';
+import { formatOrder } from '../../utils/format.js';
+import { output } from '../../utils/output.js';
+import { addEnhancedHelp } from '../../utils/helpText.js';
+import { isInteractiveEnvironment, requireParam } from '../../utils/interactive.js';
+const cmd = new Command('ship')
+    .description('Mark an order as shipped and add tracking information')
+    .option('--id <uuid>', 'Order ID (required)')
+    .option('-t, --tracking <string>', 'Tracking number (optional)')
+    .option('-c, --carrier <string>', 'Carrier name (optional)')
+    .action(async (options) => {
+    try {
+        await shipOrder(options);
+    }
+    catch (error) {
+        handleError(error);
+    }
+});
+addEnhancedHelp(cmd, {
+    examples: [
+        '# Ship an order with tracking',
+        '$ commerce order ship \\',
+        '  --id abc-123-def \\',
+        '  --tracking DHL1234567890 \\',
+        '  --carrier DHL',
+        '',
+        '# Find orders to ship, then ship',
+        '$ commerce order list --status paid',
+        '$ commerce order ship --id <order_id> --tracking UPS123 --carrier UPS',
+    ],
+    output: {
+        example: JSON.stringify({
+            success: true,
+            data: {
+                order_id: 'uuid',
+                status: 'shipped',
+                tracking_number: 'DHL1234567890',
+                carrier: 'DHL',
+                shipped_at: 'timestamp'
+            },
+            message: 'Order shipped successfully'
+        }, null, 2)
+    },
+    relatedCommands: [
+        { command: 'order list', description: 'Find orders to ship (--status paid)' },
+        { command: 'order mark-delivered', description: 'Mark order as delivered' },
+        { command: 'shipping history', description: 'View shipping history' },
+    ],
+    notes: [
+        'Order must be in \'paid\' or \'processing\' status to ship',
+        'Tracking number will be sent to customer via email',
+        'Common carriers: DHL, UPS, FedEx, USPS, China Post',
+    ]
+});
+export const shipOrderCommand = cmd;
+async function shipOrder(options) {
+    // 验证订单 ID（必需参数）
+    const orderId = isInteractiveEnvironment()
+        ? (options.id?.trim() || (() => { throw new ValidationError('订单 ID 不能为空', 'id'); })())
+        : requireParam(options.id, 'id', '订单 ID');
+    let trackingNumber = options.tracking;
+    let carrier = options.carrier;
+    // 如果没有提供物流信息且在交互环境，进入交互式模式
+    if (isInteractiveEnvironment() && !trackingNumber && !carrier) {
+        console.log(chalk.cyan('\n📦 订单发货\n'));
+        const answers = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'trackingNumber',
+                message: '物流单号 (可选):',
+                default: '',
+            },
+            {
+                type: 'input',
+                name: 'carrier',
+                message: '快递公司 (可选):',
+                default: '',
+            },
+        ]);
+        trackingNumber = answers.trackingNumber || undefined;
+        carrier = answers.carrier || undefined;
+    }
+    const spinner = output.spinner('正在标记订单已发货...');
+    try {
+        const shipData = {};
+        if (trackingNumber) {
+            shipData.tracking_number = trackingNumber;
+        }
+        if (carrier) {
+            shipData.carrier = carrier;
+        }
+        const order = await commerceApi.orders.ship(orderId, shipData);
+        spinner.succeed('订单已标记为发货！');
+        if (output.isJson()) {
+            output.success({
+                order_id: order.id || order.order_id,
+                status: order.status,
+                tracking_number: trackingNumber,
+                carrier: carrier
+            });
+        }
+        else {
+            // 显示更新后的订单信息
+            console.log();
+            console.log(formatOrder(order));
+            if (trackingNumber) {
+                console.log(chalk.gray('物流单号: ') + chalk.cyan(trackingNumber));
+            }
+            if (carrier) {
+                console.log(chalk.gray('快递公司: ') + chalk.cyan(carrier));
+            }
+            console.log();
+        }
+    }
+    catch (error) {
+        spinner.fail('订单发货失败');
+        throw createApiError(error);
+    }
+}
+//# sourceMappingURL=ship.js.map

package/dist/commands/order/ship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.js","sourceRoot":"","sources":["../../../src/commands/order/ship.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAQpF,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC5B,WAAW,CAAC,uDAAuD,CAAC;KACpE,MAAM,CAAC,aAAa,EAAE,qBAAqB,CAAC;KAC5C,MAAM,CAAC,yBAAyB,EAAE,4BAA4B,CAAC;KAC/D,MAAM,CAAC,wBAAwB,EAAE,yBAAyB,CAAC;KAC3D,MAAM,CAAC,KAAK,EAAE,OAAyB,EAAE,EAAE;IAC1C,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,eAAe,CAAC,GAAG,EAAE;IACnB,QAAQ,EAAE;QACR,+BAA+B;QAC/B,0BAA0B;QAC1B,uBAAuB;QACvB,+BAA+B;QAC/B,iBAAiB;QACjB,EAAE;QACF,kCAAkC;QAClC,qCAAqC;QACrC,uEAAuE;KACxE;IACD,MAAM,EAAE;QACN,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;YACtB,OAAO,EAAE,IAAI;YACb,IAAI,EAAE;gBACJ,QAAQ,EAAE,MAAM;gBAChB,MAAM,EAAE,SAAS;gBACjB,eAAe,EAAE,eAAe;gBAChC,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,WAAW;aACxB;YACD,OAAO,EAAE,4BAA4B;SACtC,EAAE,IAAI,EAAE,CAAC,CAAC;KACZ;IACD,eAAe,EAAE;QACf,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,qCAAqC,EAAE;QAC7E,EAAE,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,yBAAyB,EAAE;QAC3E,EAAE,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,uBAAuB,EAAE;KACtE;IACD,KAAK,EAAE;QACL,4DAA4D;QAC5D,oDAAoD;QACpD,oDAAoD;KACrD;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC,KAAK,UAAU,SAAS,CAAC,OAAyB;IAChD,gBAAgB;IAChB,MAAM,OAAO,GAAG,wBAAwB,EAAE;QACxC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,IAAI,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAE5C,IAAI,cAAc,GAAuB,OAAO,CAAC,QAAQ,CAAC;IAC1D,IAAI,OAAO,GAAuB,OAAO,CAAC,OAAO,CAAC;IAElD,2BAA2B;IAC3B,IAAI,wBAAwB,EAAE,IAAI,CAAC,cAAc,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QAEvC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;YACpC;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,YAAY;gBACrB,OAAO,EAAE,EAAE;aACZ;YACD;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,YAAY;gBACrB,OAAO,EAAE,EAAE;aACZ;SACF,CAAC,CAAC;QAEH,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,SAAS,CAAC;QACrD,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC;IACzC,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAQ,EAAE,CAAC;QAEzB,IAAI,cAAc,EAAE,CAAC;YACnB,QAAQ,CAAC,eAAe,GAAG,cAAc,CAAC;QAC5C,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;QAC7B,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC/D,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAE7B,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACpB,MAAM,CAAC,OAAO,CAAC;gBACb,QAAQ,EAAE,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,QAAQ;gBACpC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,eAAe,EAAE,cAAc;gBAC/B,OAAO,EAAE,OAAO;aACjB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,aAAa;YACb,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;YAEhC,IAAI,cAAc,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;YACjE,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YAC1D,CAAC;YAED,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/commands/product/add-images.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const addImagesCommand: Command;
+//# sourceMappingURL=add-images.d.ts.map

package/dist/commands/product/add-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-images.d.ts","sourceRoot":"","sources":["../../../src/commands/product/add-images.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsEpC,eAAO,MAAM,gBAAgB,SAAM,CAAC"}

package/dist/commands/product/add-images.js

@@ -0,0 +1,210 @@
+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('add-images')
+    .description('Add images to product (local files, URLs, or media IDs)')
+    .option('--id <uuid>', 'Product ID (required)')
+    .option('--path <paths...>', 'Local image file paths (multiple allowed)')
+    .option('--url <urls...>', 'Image URLs (multiple allowed)')
+    .option('--media-id <ids...>', 'Media IDs from upload command (multiple allowed, recommended)')
+    .action(async (options) => {
+    try {
+        await addImages(options);
+    }
+    catch (error) {
+        handleError(error);
+    }
+});
+addEnhancedHelp(cmd, {
+    examples: [
+        '# Method 1: Upload and add local files directly',
+        '$ commerce product add-images \\',
+        '  --id prod-123 \\',
+        '  --path ./photo1.jpg ./photo2.jpg',
+        '',
+        '# Method 2: Use media IDs (RECOMMENDED)',
+        '$ commerce upload image --path ./photo.jpg',
+        '# Copy media_id from response',
+        '$ commerce product add-images \\',
+        '  --id prod-123 \\',
+        '  --media-id media_456 media_789',
+        '',
+        '# Method 3: Use image URLs',
+        '$ commerce product add-images \\',
+        '  --id prod-123 \\',
+        '  --url https://example.com/image.jpg',
+    ],
+    output: {
+        example: JSON.stringify({
+            success: true,
+            data: {
+                product_id: 'uuid',
+                images: [
+                    'https://cdn.optima.shop/uploads/...',
+                    'https://cdn.optima.shop/uploads/...'
+                ],
+                count: 2
+            }
+        }, null, 2)
+    },
+    relatedCommands: [
+        { command: 'upload image', description: 'Upload images first to get media IDs' },
+        { command: 'product create', description: 'Create product with images' },
+        { command: 'product get', description: 'View current product images' },
+    ],
+    notes: [
+        'Product ID is required',
+        'Provide one of: --path, --url, or --media-id',
+        'Using --media-id is recommended (upload first, then associate)',
+        'Multiple images can be added in one command',
+        'Supported formats: JPG, PNG, GIF, WebP',
+        'Maximum file size: 10MB per image',
+    ]
+});
+export const addImagesCommand = cmd;
+async function addImages(options) {
+    // 验证参数
+    if (!options.id || options.id.trim().length === 0) {
+        throw new ValidationError('商品 ID 不能为空', 'id');
+    }
+    const productId = options.id;
+    const { path: localPaths = [], url: imageUrls = [], mediaId: mediaIds = [] } = options;
+    if (localPaths.length === 0 && imageUrls.length === 0 && mediaIds.length === 0) {
+        throw new ValidationError('请至少提供一张图片（--path、--url 或 --media-id）', 'images');
+    }
+    console.log(chalk.cyan('\n📷 验证输入...\n'));
+    // 1. 如果有 Media IDs，直接关联
+    if (mediaIds.length > 0) {
+        console.log(chalk.green(`✓ Media IDs: ${mediaIds.length} 个`));
+        console.log();
+        const spinner = output.spinner(`正在关联 ${mediaIds.length} 张图片...`);
+        try {
+            const result = await commerceApi.products.addImagesByMediaIds(productId, mediaIds);
+            spinner.succeed(`图片关联成功！(${mediaIds.length} 张)`);
+            if (output.isJson()) {
+                output.success({
+                    product_id: productId,
+                    images: result.images || [],
+                    count: (result.images || []).length
+                });
+            }
+            else {
+                console.log();
+                if (result.images && result.images.length > 0) {
+                    console.log(chalk.gray('已关联的图片 URL:'));
+                    result.images.forEach((item, index) => {
+                        const url = typeof item === 'string' ? item : (item.url || item.image_url || item);
+                        console.log(chalk.gray(`  ${index + 1}. `) + chalk.cyan(url));
+                    });
+                }
+                console.log();
+            }
+            return;
+        }
+        catch (error) {
+            spinner.fail('图片关联失败');
+            throw createApiError(error);
+        }
+    }
+    // 2. 验证本地文件
+    const localFiles = [];
+    for (const path of localPaths) {
+        if (!existsSync(path)) {
+            console.log(chalk.red(`✗ 文件不存在: ${path}`));
+            continue;
+        }
+        const stats = statSync(path);
+        const fileSize = stats.size;
+        // 检查文件大小（限制 10MB）
+        if (fileSize > 10 * 1024 * 1024) {
+            console.log(chalk.red(`✗ 文件过大 (${formatFileSize(fileSize)}): ${path}`));
+            continue;
+        }
+        // 检查文件扩展名
+        const ext = path.toLowerCase().split('.').pop();
+        if (!['jpg', 'jpeg', 'png', 'gif', 'webp'].includes(ext || '')) {
+            console.log(chalk.red(`✗ 不支持的图片格式: ${path}`));
+            continue;
+        }
+        console.log(chalk.green(`✓ ${path} (${formatFileSize(fileSize)})`));
+        localFiles.push(path);
+    }
+    // 3. 显示 URLs
+    for (const url of imageUrls) {
+        console.log(chalk.green(`✓ URL: ${url}`));
+    }
+    if (localFiles.length === 0 && imageUrls.length === 0) {
+        throw new ValidationError('没有有效的图片文件或 URL', 'images');
+    }
+    console.log();
+    // 如果有 URL，直接用 image_urls API
+    if (imageUrls.length > 0 && localFiles.length === 0) {
+        const spinner = output.spinner(`正在关联 ${imageUrls.length} 张图片...`);
+        try {
+            const result = await commerceApi.products.addImageUrls(productId, imageUrls);
+            spinner.succeed(`图片关联成功！(${imageUrls.length} 张)`);
+            if (output.isJson()) {
+                output.success({
+                    product_id: productId,
+                    images: result.images || [],
+                    count: (result.images || []).length
+                });
+            }
+            else {
+                console.log();
+                if (result.images && result.images.length > 0) {
+                    console.log(chalk.gray('已关联的图片 URL:'));
+                    result.images.forEach((item, index) => {
+                        // 支持字符串或对象格式
+                        const url = typeof item === 'string' ? item : (item.url || item.image_url || item);
+                        console.log(chalk.gray(`  ${index + 1}. `) + chalk.cyan(url));
+                    });
+                }
+                console.log();
+            }
+        }
+        catch (error) {
+            spinner.fail('图片关联失败');
+            throw createApiError(error);
+        }
+        return;
+    }
+    // 如果有本地文件，上传
+    if (localFiles.length > 0) {
+        const spinner = output.spinner(`正在上传 ${localFiles.length} 张图片...`);
+        try {
+            const result = await commerceApi.products.addImages(productId, localFiles);
+            spinner.succeed(`图片上传成功！(${localFiles.length} 张)`);
+            if (output.isJson()) {
+                output.success({
+                    product_id: productId,
+                    images: result.images || [],
+                    count: (result.images || []).length
+                });
+            }
+            else {
+                console.log();
+                if (result.images && result.images.length > 0) {
+                    console.log(chalk.gray('已上传的图片 URL:'));
+                    result.images.forEach((item, index) => {
+                        // 支持字符串或对象格式
+                        const url = typeof item === 'string' ? item : (item.url || item.image_url || item);
+                        console.log(chalk.gray(`  ${index + 1}. `) + chalk.cyan(url));
+                    });
+                }
+                console.log();
+            }
+        }
+        catch (error) {
+            spinner.fail('图片上传失败');
+            throw createApiError(error);
+        }
+    }
+    // TODO: 如果同时有 URL 和本地文件，需要分两步处理
+}
+//# sourceMappingURL=add-images.js.map

package/dist/commands/product/add-images.js.map

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