@optima-chat/commerce-cli 1.0.0

package/dist/api/rest/commerce.js

@@ -0,0 +1,935 @@
+import { createAuthenticatedClient } from './base.js';
+import FormData from 'form-data';
+import { createReadStream } from 'fs';
+import path from 'path';
+import { createHash } from 'crypto';
+import { getApiUrl } from '../../utils/config.js';
+// 辅助函数：清理文件名，移除非ASCII字符
+function sanitizeFilename(filename) {
+    const ext = path.extname(filename);
+    const basename = path.basename(filename, ext);
+    // 如果文件名包含非ASCII字符，使用hash
+    if (!/^[\x00-\x7F]*$/.test(basename)) {
+        const hash = createHash('md5').update(basename).digest('hex').substring(0, 8);
+        return `upload-${hash}${ext}`;
+    }
+    return filename;
+}
+// ============================================================================
+// Commerce API 客户端
+// ============================================================================
+class CommerceApiClient {
+    client;
+    constructor() {
+        // 优先级：环境变量 > 配置文件 > 默认值
+        this.client = createAuthenticatedClient(getApiUrl());
+    }
+    /**
+     * 重新初始化客户端（当 API URL 改变时调用）
+     */
+    reinitialize() {
+        this.client = createAuthenticatedClient(getApiUrl());
+    }
+    // ==========================================================================
+    // 商品管理 (products)
+    // ==========================================================================
+    products = {
+        /**
+         * 创建商品
+         */
+        create: async (data) => {
+            const response = await this.client.post('/api/products', data);
+            return response.data;
+        },
+        /**
+         * 商品列表
+         */
+        list: async (params) => {
+            const response = await this.client.get('/api/products', { params });
+            const data = response.data;
+            // 处理不同的响应格式
+            if (data.items) {
+                // 新格式: { items: [...] }
+                return {
+                    products: data.items,
+                    total: data.total || data.items.length,
+                };
+            }
+            // 旧格式: { products: [...], total: number }
+            return {
+                products: data.products || [],
+                total: data.total || 0,
+            };
+        },
+        /**
+         * 商品详情
+         */
+        get: async (productId) => {
+            const response = await this.client.get(`/api/products/${productId}`);
+            return response.data;
+        },
+        /**
+         * 更新商品
+         */
+        update: async (productId, data) => {
+            const response = await this.client.put(`/api/products/${productId}`, data);
+            return response.data;
+        },
+        /**
+         * 删除商品（软删除）
+         */
+        delete: async (productId) => {
+            await this.client.delete(`/api/products/${productId}`);
+        },
+        /**
+         * 添加商品图片（两步流程）
+         * 1. 先上传图片到存储获取 media_id
+         * 2. 再关联 media_id 到商品
+         */
+        addImages: async (productId, imagePaths) => {
+            // 第1步：上传图片获取 media_id
+            const mediaIds = [];
+            for (const imagePath of imagePaths) {
+                const formData = new FormData();
+                const filename = sanitizeFilename(path.basename(imagePath));
+                formData.append('file', createReadStream(imagePath), {
+                    filename: filename,
+                });
+                const uploadResponse = await this.client.post('/api/upload/image', formData, {
+                    headers: {
+                        ...formData.getHeaders(),
+                    },
+                });
+                if (uploadResponse.data.media_id) {
+                    mediaIds.push(uploadResponse.data.media_id);
+                }
+            }
+            // 第2步：关联图片到商品
+            const response = await this.client.post(`/api/products/${productId}/images`, { media_ids: mediaIds });
+            return response.data;
+        },
+        /**
+         * 添加商品图片（通过 URL）
+         * 直接用图片 URL 关联到商品（后端会下载）
+         */
+        addImageUrls: async (productId, imageUrls) => {
+            const response = await this.client.post(`/api/products/${productId}/images`, { image_urls: imageUrls });
+            return response.data;
+        },
+        /**
+         * 添加商品图片（通过 Media ID）
+         * 直接用 media_id 关联到商品（从 upload 命令获取）
+         */
+        addImagesByMediaIds: async (productId, mediaIds) => {
+            const response = await this.client.post(`/api/products/${productId}/images`, { media_ids: mediaIds });
+            return response.data;
+        },
+    };
+    // ==========================================================================
+    // 订单管理 (orders)
+    // ==========================================================================
+    orders = {
+        /**
+         * 商户订单列表
+         */
+        list: async (params) => {
+            const response = await this.client.get('/api/orders/merchant', { params });
+            const data = response.data;
+            // 处理不同的响应格式
+            if (data.items) {
+                // 新格式: { items: [...] }
+                return {
+                    orders: data.items,
+                    total: data.total || data.items.length,
+                };
+            }
+            // 旧格式: { orders: [...], total: number }
+            return {
+                orders: data.orders || [],
+                total: data.total || 0,
+            };
+        },
+        /**
+         * 订单详情
+         */
+        get: async (orderId) => {
+            const response = await this.client.get(`/api/orders/merchant/${orderId}`);
+            return response.data;
+        },
+        /**
+         * 标记订单已发货
+         */
+        ship: async (orderId, data) => {
+            const response = await this.client.post(`/api/orders/merchant/${orderId}/ship`, data);
+            return response.data;
+        },
+        /**
+         * 完成订单
+         */
+        complete: async (orderId) => {
+            const response = await this.client.post(`/api/orders/merchant/${orderId}/complete`);
+            return response.data;
+        },
+        /**
+         * 取消订单
+         */
+        cancel: async (orderId, reason) => {
+            const response = await this.client.post(`/api/orders/merchant/${orderId}/cancel`, { reason });
+            return response.data;
+        },
+        /**
+         * 标记已送达
+         */
+        markDelivered: async (orderId) => {
+            const response = await this.client.post(`/api/orders/merchant/${orderId}/mark-delivered`, {});
+            return response.data;
+        },
+    };
+    // ==========================================================================
+    // 库存管理 (inventory)
+    // ==========================================================================
+    inventory = {
+        /**
+         * 获取低库存商品
+         */
+        getLowStock: async (threshold) => {
+            const response = await this.client.get('/api/inventory/low-stock', {
+                params: { threshold },
+            });
+            // 处理不同的响应格式
+            const data = response.data;
+            if (Array.isArray(data)) {
+                return data;
+            }
+            return data.items || [];
+        },
+        /**
+         * 调整商品库存
+         */
+        updateStock: async (productId, quantity, reason) => {
+            const response = await this.client.put(`/api/inventory/products/${productId}/stock`, {
+                quantity,
+                reason: reason || 'Manual adjustment',
+            });
+            return response.data;
+        },
+        /**
+         * 查看库存变更历史
+         */
+        getHistory: async (productId) => {
+            const response = await this.client.get(`/api/inventory/products/${productId}/history`);
+            return response.data;
+        },
+        /**
+         * 预留库存（购物车功能）
+         */
+        reserveStock: async (productId, quantity) => {
+            const response = await this.client.post(`/api/inventory/products/${productId}/reserve`, {
+                quantity,
+            });
+            return response.data;
+        },
+    };
+    // ==========================================================================
+    // 商户管理 (merchant)
+    // ==========================================================================
+    merchant = {
+        /**
+         * 获取当前商户信息
+         */
+        getProfile: async () => {
+            const response = await this.client.get('/api/merchants/me');
+            return response.data;
+        },
+        /**
+         * 更新商户资料
+         */
+        updateProfile: async (data) => {
+            const response = await this.client.put('/api/merchants/me', data);
+            return response.data;
+        },
+        /**
+         * 初始化 OAuth 用户的商户资料
+         */
+        setupProfile: async (data) => {
+            const response = await this.client.post('/api/merchants/me', data);
+            return response.data;
+        },
+    };
+    // ==========================================================================
+    // 物流管理 (shipping)
+    // ==========================================================================
+    shipping = {
+        /**
+         * 更新物流状态
+         */
+        updateShippingStatus: async (orderId, data) => {
+            const response = await this.client.post(`/api/orders/merchant/${orderId}/update-shipping-status`, data);
+            return response.data;
+        },
+        /**
+         * 获取物流历史
+         */
+        getShippingHistory: async (orderId) => {
+            const response = await this.client.get(`/api/orders/merchant/${orderId}/shipping-history`);
+            return response.data;
+        },
+        /**
+         * 添加物流备注
+         */
+        addShippingNote: async (orderId, note) => {
+            const response = await this.client.post(`/api/orders/merchant/${orderId}/add-shipping-note`, {
+                note,
+            });
+            return response.data;
+        },
+        /**
+         * 获取支持的国家列表
+         */
+        listCountries: async () => {
+            const response = await this.client.get('/api/shipping/countries');
+            return response.data;
+        },
+        /**
+         * 获取当前物流模式
+         */
+        getMode: async () => {
+            const response = await this.client.get('/api/shipping/mode');
+            return response.data;
+        },
+        /**
+         * 切换物流模式
+         */
+        setMode: async (mode) => {
+            await this.client.post('/api/shipping/mode', { mode });
+        },
+    };
+    // ==========================================================================
+    // 固定运费配置 (shipping-fixed)
+    // ==========================================================================
+    shippingFixed = {
+        /**
+         * 获取固定运费全局配置
+         */
+        getConfig: async () => {
+            const response = await this.client.get('/api/shipping/fixed/config');
+            return response.data;
+        },
+        /**
+         * 更新全局配置
+         */
+        updateConfig: async (data) => {
+            const response = await this.client.post('/api/shipping/fixed/config', data);
+            return response.data;
+        },
+        /**
+         * 计算订单运费
+         */
+        calculate: async (data) => {
+            const response = await this.client.post('/api/shipping/fixed/calculate', data);
+            return response.data;
+        },
+        /**
+         * 获取运费区域列表
+         */
+        listZones: async () => {
+            const response = await this.client.get('/api/shipping/fixed/zones');
+            return response.data.zones;
+        },
+        /**
+         * 创建运费区域
+         */
+        createZone: async (data) => {
+            const response = await this.client.post('/api/shipping/fixed/zones', data);
+            return response.data;
+        },
+        /**
+         * 获取运费区域详情
+         */
+        getZone: async (zoneId) => {
+            const response = await this.client.get(`/api/shipping/fixed/zones/${zoneId}`);
+            return response.data;
+        },
+        /**
+         * 更新运费区域
+         */
+        updateZone: async (zoneId, data) => {
+            const response = await this.client.put(`/api/shipping/fixed/zones/${zoneId}`, data);
+            return response.data;
+        },
+        /**
+         * 删除运费区域
+         */
+        deleteZone: async (zoneId) => {
+            await this.client.delete(`/api/shipping/fixed/zones/${zoneId}`);
+        },
+        /**
+         * 获取区域运费费率
+         */
+        listRates: async (zoneId) => {
+            const response = await this.client.get(`/api/shipping/fixed/zones/${zoneId}`);
+            return response.data.rates || [];
+        },
+        /**
+         * 创建运费费率
+         */
+        createRate: async (zoneId, data) => {
+            const response = await this.client.post(`/api/shipping/fixed/zones/${zoneId}/rates`, data);
+            // API returns full zone, extract the newly created rate (last in array)
+            const rates = response.data.rates || [];
+            if (rates.length === 0) {
+                throw new Error('Failed to create rate: no rates returned');
+            }
+            return rates[rates.length - 1];
+        },
+        /**
+         * 更新运费费率
+         */
+        updateRate: async (zoneId, rateId, data) => {
+            const response = await this.client.put(`/api/shipping/fixed/zones/${zoneId}/rates/${rateId}`, data);
+            // API returns full zone, find the updated rate by ID
+            const rate = response.data.rates?.find(r => r.id === rateId);
+            if (!rate) {
+                throw new Error(`Failed to find updated rate: ${rateId}`);
+            }
+            return rate;
+        },
+        /**
+         * 删除运费费率
+         */
+        deleteRate: async (zoneId, rateId) => {
+            await this.client.delete(`/api/shipping/fixed/zones/${zoneId}/rates/${rateId}`);
+        },
+    };
+    // ==========================================================================
+    // 对话管理 (conversations)
+    // ==========================================================================
+    conversations = {
+        /**
+         * 创建对话
+         */
+        create: async (data) => {
+            const response = await this.client.post('/api/conversations', data);
+            return response.data;
+        },
+        /**
+         * 获取对话列表
+         */
+        list: async (params) => {
+            const response = await this.client.get('/api/conversations', { params });
+            return response.data;
+        },
+        /**
+         * 获取对话详情
+         */
+        get: async (conversationId) => {
+            const response = await this.client.get(`/api/conversations/${conversationId}`);
+            return response.data;
+        },
+        /**
+         * 更新对话状态
+         */
+        update: async (conversationId, data) => {
+            const response = await this.client.patch(`/api/conversations/${conversationId}`, data);
+            return response.data;
+        },
+        /**
+         * 发送消息
+         */
+        sendMessage: async (conversationId, data) => {
+            const response = await this.client.post(`/api/conversations/${conversationId}/messages`, data);
+            return response.data;
+        },
+        /**
+         * 获取消息列表
+         */
+        getMessages: async (conversationId, params) => {
+            const response = await this.client.get(`/api/conversations/${conversationId}/messages`, { params });
+            return response.data;
+        },
+        /**
+         * 标记消息已读
+         */
+        markRead: async (conversationId) => {
+            const response = await this.client.post(`/api/conversations/${conversationId}/messages/mark-read`);
+            return response.data;
+        },
+        /**
+         * 获取对话上下文
+         */
+        getContext: async (conversationId) => {
+            const response = await this.client.get(`/api/conversations/${conversationId}/context`);
+            return response.data;
+        },
+    };
+    // ==========================================================================
+    // 商品变体 (variants)
+    // ==========================================================================
+    variants = {
+        /**
+         * 获取商品变体列表
+         */
+        list: async (productId) => {
+            const response = await this.client.get(`/api/products/${productId}/variants`);
+            const data = response.data;
+            // 处理不同的响应格式
+            if (Array.isArray(data)) {
+                return data;
+            }
+            if (data.items) {
+                return data.items;
+            }
+            if (data.variants) {
+                return data.variants;
+            }
+            return [];
+        },
+        /**
+         * 搜索商品变体
+         */
+        search: async (productId, criteria) => {
+            const response = await this.client.post(`/api/products/${productId}/variants/search`, criteria);
+            return response.data;
+        },
+        /**
+         * 创建商品变体
+         */
+        create: async (productId, data) => {
+            const response = await this.client.post(`/api/products/${productId}/variants`, data);
+            return response.data;
+        },
+        /**
+         * 获取变体详情
+         */
+        get: async (productId, variantId) => {
+            const response = await this.client.get(`/api/products/${productId}/variants/${variantId}`);
+            return response.data;
+        },
+        /**
+         * 更新变体
+         */
+        update: async (productId, variantId, data) => {
+            const response = await this.client.put(`/api/products/${productId}/variants/${variantId}`, data);
+            return response.data;
+        },
+        /**
+         * 删除变体
+         */
+        delete: async (productId, variantId) => {
+            await this.client.delete(`/api/products/${productId}/variants/${variantId}`);
+        },
+        /**
+         * 添加变体图片（两步流程）
+         * 1. 先上传图片到存储获取 media_id
+         * 2. 再关联 media_id 到变体
+         */
+        addImages: async (masterId, variantId, imagePaths) => {
+            // 第1步：上传图片获取 media_id
+            const mediaIds = [];
+            for (const imagePath of imagePaths) {
+                const formData = new FormData();
+                const filename = sanitizeFilename(path.basename(imagePath));
+                formData.append('file', createReadStream(imagePath), {
+                    filename: filename,
+                });
+                const uploadResponse = await this.client.post('/api/upload/image', formData, {
+                    headers: {
+                        ...formData.getHeaders(),
+                    },
+                });
+                if (uploadResponse.data.media_id) {
+                    mediaIds.push(uploadResponse.data.media_id);
+                }
+            }
+            // 第2步：关联图片到变体
+            const response = await this.client.post(`/api/products/${masterId}/variants/${variantId}/images`, { media_ids: mediaIds });
+            return response.data;
+        },
+        /**
+         * 添加变体图片（通过 Media ID）
+         * 直接用 media_id 关联到变体（从 upload 命令获取）
+         */
+        addImagesByMediaIds: async (masterId, variantId, mediaIds) => {
+            const response = await this.client.post(`/api/products/${masterId}/variants/${variantId}/images`, { media_ids: mediaIds });
+            return response.data;
+        },
+    };
+    // ==========================================================================
+    // 退款管理 (refunds)
+    // ==========================================================================
+    refunds = {
+        /**
+         * 创建退款
+         */
+        create: async (data) => {
+            const response = await this.client.post('/api/refunds/create', data);
+            return response.data;
+        },
+        /**
+         * 获取退款详情
+         */
+        get: async (refundId) => {
+            const response = await this.client.get(`/api/refunds/${refundId}`);
+            return response.data;
+        },
+    };
+    // ==========================================================================
+    // 文件上传 (upload)
+    // ==========================================================================
+    upload = {
+        /**
+         * 上传图片
+         */
+        uploadImage: async (imagePath) => {
+            const formData = new FormData();
+            const filename = sanitizeFilename(path.basename(imagePath));
+            formData.append('file', createReadStream(imagePath), {
+                filename: filename,
+            });
+            const response = await this.client.post('/api/upload/image', formData, {
+                headers: {
+                    ...formData.getHeaders(),
+                },
+            });
+            return response.data;
+        },
+        /**
+         * 上传视频
+         */
+        uploadVideo: async (videoPath) => {
+            const formData = new FormData();
+            formData.append('file', createReadStream(videoPath));
+            const response = await this.client.post('/api/upload/video', formData, {
+                headers: {
+                    ...formData.getHeaders(),
+                },
+            });
+            return response.data;
+        },
+        /**
+         * 上传文件
+         */
+        uploadFile: async (filePath) => {
+            const formData = new FormData();
+            formData.append('file', createReadStream(filePath));
+            const response = await this.client.post('/api/upload/file', formData, {
+                headers: {
+                    ...formData.getHeaders(),
+                },
+            });
+            return response.data;
+        },
+    };
+    // ==========================================================================
+    // 财务管理 (transfers)
+    // ==========================================================================
+    transfers = {
+        list: async () => {
+            const response = await this.client.get('/api/transfers/merchant');
+            return response.data.transfers || response.data || [];
+        },
+        summary: async () => {
+            const response = await this.client.get('/api/transfers/merchant/summary');
+            return response.data;
+        },
+    };
+    // ==========================================================================
+    // 国际化翻译 (i18n)
+    // ==========================================================================
+    i18n = {
+        /**
+         * 获取支持的语言列表
+         */
+        listLanguages: async (activeOnly = true) => {
+            const response = await this.client.get('/api/languages', {
+                params: { active_only: activeOnly },
+            });
+            return response.data;
+        },
+        // 商品翻译
+        productTranslations: {
+            list: async (productId) => {
+                const response = await this.client.get(`/api/products/${productId}/translations`);
+                return response.data;
+            },
+            get: async (productId, languageCode) => {
+                const response = await this.client.get(`/api/products/${productId}/translations/${languageCode}`);
+                return response.data;
+            },
+            create: async (productId, data) => {
+                const response = await this.client.post(`/api/products/${productId}/translations`, data);
+                return response.data;
+            },
+            update: async (productId, languageCode, data) => {
+                const response = await this.client.put(`/api/products/${productId}/translations/${languageCode}`, data);
+                return response.data;
+            },
+            delete: async (productId, languageCode) => {
+                await this.client.delete(`/api/products/${productId}/translations/${languageCode}`);
+            },
+        },
+        // 集合翻译
+        collectionTranslations: {
+            list: async (collectionId) => {
+                const response = await this.client.get(`/api/collections/${collectionId}/translations`);
+                return response.data;
+            },
+            get: async (collectionId, languageCode) => {
+                const response = await this.client.get(`/api/collections/${collectionId}/translations/${languageCode}`);
+                return response.data;
+            },
+            create: async (collectionId, data) => {
+                const response = await this.client.post(`/api/collections/${collectionId}/translations`, data);
+                return response.data;
+            },
+            update: async (collectionId, languageCode, data) => {
+                const response = await this.client.put(`/api/collections/${collectionId}/translations/${languageCode}`, data);
+                return response.data;
+            },
+            delete: async (collectionId, languageCode) => {
+                await this.client.delete(`/api/collections/${collectionId}/translations/${languageCode}`);
+            },
+        },
+        // 商户翻译
+        merchantTranslations: {
+            list: async () => {
+                const response = await this.client.get('/api/merchants/me/translations');
+                return response.data;
+            },
+            get: async (languageCode) => {
+                const response = await this.client.get(`/api/merchants/me/translations/${languageCode}`);
+                return response.data;
+            },
+            create: async (data) => {
+                const response = await this.client.post('/api/merchants/me/translations', data);
+                return response.data;
+            },
+            update: async (languageCode, data) => {
+                const response = await this.client.put(`/api/merchants/me/translations/${languageCode}`, data);
+                return response.data;
+            },
+            delete: async (languageCode) => {
+                await this.client.delete(`/api/merchants/me/translations/${languageCode}`);
+            },
+        },
+    };
+    // ==========================================================================
+    // 首页配置 (homepage)
+    // ==========================================================================
+    homepage = {
+        sections: {
+            /**
+             * 列出所有 sections
+             */
+            list: async () => {
+                const response = await this.client.get('/api/v1/merchants/me/homepage-config/sections');
+                return response.data;
+            },
+            /**
+             * 创建 section
+             */
+            create: async (data) => {
+                const response = await this.client.post('/api/v1/merchants/me/homepage-config/sections', data);
+                return response.data;
+            },
+            /**
+             * 获取单个 section
+             */
+            get: async (id, expand) => {
+                const response = await this.client.get(`/api/v1/merchants/me/homepage-config/sections/${id}`, {
+                    params: expand ? { expand } : undefined,
+                });
+                return response.data;
+            },
+            /**
+             * 更新 section
+             */
+            update: async (id, data) => {
+                const response = await this.client.put(`/api/v1/merchants/me/homepage-config/sections/${id}`, data);
+                return response.data;
+            },
+            /**
+             * 删除 section
+             */
+            delete: async (id) => {
+                await this.client.delete(`/api/v1/merchants/me/homepage-config/sections/${id}`);
+            },
+            /**
+             * 重排序 sections
+             */
+            reorder: async (moves) => {
+                const response = await this.client.put('/api/v1/merchants/me/homepage-config/sections/reorder', {
+                    moves,
+                });
+                return response.data;
+            },
+        },
+        settings: {
+            /**
+             * 更新 Banner 图片
+             */
+            updateImages: async (id, images) => {
+                const response = await this.client.put(`/api/v1/merchants/me/homepage-config/sections/${id}/settings/images`, {
+                    images,
+                });
+                return response.data;
+            },
+            /**
+             * 更新 Collections 列表
+             */
+            updateCollections: async (id, collection_slugs) => {
+                const response = await this.client.put(`/api/v1/merchants/me/homepage-config/sections/${id}/settings/collections`, {
+                    collection_slugs,
+                });
+                return response.data;
+            },
+            /**
+             * 更新 Collection Products 目标集合
+             */
+            updateCollectionSlug: async (id, collection_slug) => {
+                const response = await this.client.put(`/api/v1/merchants/me/homepage-config/sections/${id}/settings/collection`, {
+                    collection_slug,
+                });
+                return response.data;
+            },
+            /**
+             * 更新 Featured 目标
+             */
+            updateTarget: async (id, target_type, target_handle) => {
+                const response = await this.client.put(`/api/v1/merchants/me/homepage-config/sections/${id}/settings/target`, {
+                    target_type,
+                    target_handle,
+                });
+                return response.data;
+            },
+            /**
+             * 通用设置补丁
+             */
+            patch: async (id, settings) => {
+                const response = await this.client.patch(`/api/v1/merchants/me/homepage-config/sections/${id}/settings`, {
+                    updates: settings,
+                });
+                return response.data;
+            },
+        },
+        translations: {
+            /**
+             * 列出所有翻译
+             */
+            list: async (sectionId) => {
+                const response = await this.client.get(`/api/v1/merchants/me/homepage-config/sections/${sectionId}/translations`);
+                return response.data;
+            },
+            /**
+             * 创建或更新翻译 (upsert)
+             */
+            set: async (sectionId, lang, data) => {
+                const response = await this.client.put(`/api/v1/merchants/me/homepage-config/sections/${sectionId}/translations/${lang}`, data);
+                return response.data;
+            },
+            /**
+             * 删除翻译
+             */
+            delete: async (sectionId, lang) => {
+                await this.client.delete(`/api/v1/merchants/me/homepage-config/sections/${sectionId}/translations/${lang}`);
+            },
+        },
+    };
+    // ==========================================================================
+    // Collections 管理
+    // ==========================================================================
+    collections = {
+        /**
+         * 列出所有 collections
+         */
+        list: async (params) => {
+            const response = await this.client.get('/api/collections', { params });
+            return response.data;
+        },
+        /**
+         * 创建 collection
+         */
+        create: async (data) => {
+            const response = await this.client.post('/api/collections', data);
+            return response.data;
+        },
+        /**
+         * 获取单个 collection
+         */
+        get: async (id) => {
+            const response = await this.client.get(`/api/collections/${id}`);
+            return response.data;
+        },
+        /**
+         * 更新 collection
+         */
+        update: async (id, data) => {
+            const response = await this.client.put(`/api/collections/${id}`, data);
+            return response.data;
+        },
+        /**
+         * 删除 collection
+         */
+        delete: async (id) => {
+            await this.client.delete(`/api/collections/${id}`);
+        },
+        /**
+         * 添加商品到 collection
+         */
+        addProducts: async (id, productIds) => {
+            await this.client.post(`/api/collections/${id}/products`, { product_ids: productIds });
+        },
+        /**
+         * 从 collection 移除商品
+         * Note: Backend API 不支持批量删除，需要对每个产品发送单独的 DELETE 请求
+         */
+        removeProducts: async (id, productIds) => {
+            // 串行删除每个产品
+            for (const productId of productIds) {
+                await this.client.delete(`/api/collections/${id}/products/${productId}`);
+            }
+        },
+        /**
+         * 列出 collection 中的商品
+         */
+        listProducts: async (id, params) => {
+            const response = await this.client.get(`/api/collections/${id}/products`, { params });
+            return response.data;
+        },
+    };
+    // ==========================================================================
+    // Tags 管理
+    // ==========================================================================
+    tags = {
+        /**
+         * 列出所有 tags
+         */
+        list: async () => {
+            const response = await this.client.get('/api/v1/merchants/me/tags');
+            return response.data;
+        },
+        /**
+         * 创建 tag
+         */
+        create: async (name) => {
+            const response = await this.client.post('/api/v1/merchants/me/tags', { name });
+            return response.data;
+        },
+        /**
+         * 删除 tag
+         */
+        delete: async (name) => {
+            await this.client.delete(`/api/v1/merchants/me/tags/${encodeURIComponent(name)}`);
+        },
+        /**
+         * 获取 tag 统计信息
+         */
+        stats: async (name) => {
+            const response = await this.client.get(`/api/v1/merchants/me/tags/${encodeURIComponent(name)}/stats`);
+            return response.data;
+        },
+    };
+}
+// 导出单例实例
+export const commerceApi = new CommerceApiClient();
+//# sourceMappingURL=commerce.js.map