@gt6/sdk 1.0.23 → 1.0.24

package/dist/gt6-sdk.esm.js

@@ -372,6 +372,65 @@ class ProductsAPI {
         }
         return product;
     }
+    /**
+     * 1.1. 根据产品ID获取父平台产品详情
+     */
+    async getProduct_p(productId) {
+        const product = await this.client.request(`/parentproducts/${productId}.json`);
+        // 检查产品是否有销售区域和税费模板
+        if (product.regions && product.regions.length > 0 &&
+            product.taxTemplates && product.taxTemplates.length > 0) {
+            try {
+                // 获取税费信息
+                const taxInfo = await this.getTaxInfo();
+                // 为每个税费模板添加规则
+                product.taxTemplates = product.taxTemplates.map(template => {
+                    const matchingTemplate = taxInfo.templates.find(t => t.templateId === template.templateId);
+                    if (matchingTemplate) {
+                        // 过滤出产品可销售区域的规则
+                        const productRegionIds = product.regions.map(r => r.regionId);
+                        const applicableRules = matchingTemplate.rules.filter(rule => productRegionIds.includes(rule.regionId));
+                        return {
+                            ...template,
+                            rules: applicableRules
+                        };
+                    }
+                    return template;
+                });
+            }
+            catch (error) {
+                // 如果获取税费信息失败，不影响产品详情返回
+                console.warn('Failed to fetch tax info:', error);
+            }
+        }
+        // 检查产品是否有销售区域和运费模板
+        if (product.regions && product.regions.length > 0 &&
+            product.shippingTemplates && product.shippingTemplates.length > 0) {
+            try {
+                // 获取运费信息
+                const shippingInfo = await this.getShippingInfo();
+                // 为每个运费模板添加规则
+                product.shippingTemplates = product.shippingTemplates.map(template => {
+                    const matchingTemplate = shippingInfo.templates.find(t => t.templateId === template.templateId);
+                    if (matchingTemplate) {
+                        // 过滤出产品可销售区域的规则
+                        const productRegionIds = product.regions.map(r => r.regionId);
+                        const applicableRules = matchingTemplate.rules.filter(rule => productRegionIds.includes(rule.regionId));
+                        return {
+                            ...template,
+                            rules: applicableRules
+                        };
+                    }
+                    return template;
+                });
+            }
+            catch (error) {
+                // 如果获取运费信息失败，不影响产品详情返回
+                console.warn('Failed to fetch shipping info:', error);
+            }
+        }
+        return product;
+    }
     /**
      * 2. 获取产品分类列表
      */
@@ -381,6 +440,15 @@ class ProductsAPI {
         const response = await this.client.request(`/product-categories/platform-${config.platformId}-root-${categoryId}.json`);
         return response.categories;
     }
+    /**
+     * 2.1. 获取平台产品分类列表
+     */
+    async getCategories_p(productRootCategoryId_p) {
+        const config = this.client.getConfig();
+        const categoryId = productRootCategoryId_p || config.productRootCategoryId_p;
+        const response = await this.client.request(`/product-categories/platform-${config.platformId_p}-root-${categoryId}.json`);
+        return response.categories;
+    }
     /**
      * 3. 获取产品标签列表
      */
@@ -390,6 +458,15 @@ class ProductsAPI {
         const response = await this.client.request(`/product-tags/platform-${config.platformId}-${alias}.json`);
         return response.tags;
     }
+    /**
+     * 3.1. 获取平台产品标签列表
+     */
+    async getTags_p(productTagAlias_p) {
+        const config = this.client.getConfig();
+        const alias = productTagAlias_p || config.productTagAlias_p;
+        const response = await this.client.request(`/product-tags/platform-${config.platformId_p}-${alias}.json`);
+        return response.tags;
+    }
     /**
      * 4. 根据分类ID获取产品列表
      * 支持单个分类ID或分类ID数组
@@ -450,6 +527,124 @@ class ProductsAPI {
             limit
         };
     }
+    /**
+     * 4.1. 根据分类ID获取平台产品列表
+     */
+    async getProductsByCategory_p(categoryId, options) {
+        // 获取分类数据
+        const categories = await this.getCategories_p();
+        // 递归查找分类的函数
+        const findCategoryById = (cats, targetId) => {
+            for (const cat of cats) {
+                if (cat.categoryId === targetId) {
+                    return cat;
+                }
+                if (cat.children && cat.children.length > 0) {
+                    const found = findCategoryById(cat.children, targetId);
+                    if (found)
+                        return found;
+                }
+            }
+            return null;
+        };
+        // 将单个分类ID转换为数组
+        const categoryIds = Array.isArray(categoryId) ? categoryId : [categoryId];
+        // 收集所有指定分类下的产品ID
+        const allProductIds = [];
+        categoryIds.forEach(id => {
+            const targetCategory = findCategoryById(categories, id);
+            if (targetCategory) {
+                allProductIds.push(...targetCategory.productIds);
+            }
+        });
+        // 去重
+        const uniqueProductIds = [...new Set(allProductIds)];
+        if (uniqueProductIds.length === 0) {
+            return {
+                products: [],
+                total: 0,
+                page: options?.page || 1,
+                limit: options?.limit || 10
+            };
+        }
+        // 应用分页
+        const page = options?.page || 1;
+        const limit = options?.limit || 10;
+        const offset = (page - 1) * limit;
+        const paginatedProductIds = uniqueProductIds.slice(offset, offset + limit);
+        // 获取产品详情
+        const products = await Promise.all(paginatedProductIds.map(productId => this.getProduct_p(productId)));
+        // 应用状态过滤
+        let filteredProducts = products;
+        if (options?.status !== undefined) {
+            filteredProducts = products.filter(product => product.status === options.status);
+        }
+        return {
+            products: filteredProducts,
+            total: uniqueProductIds.length,
+            page,
+            limit
+        };
+    }
+    /**
+     * 4.2. 根据分类ID获取平台产品列表
+     */
+    async getProductsByCategory_t(categoryId, options) {
+        // 获取分类数据
+        const categories = await this.getCategories();
+        // 递归查找分类的函数
+        const findCategoryById = (cats, targetId) => {
+            for (const cat of cats) {
+                if (cat.categoryId === targetId) {
+                    return cat;
+                }
+                if (cat.children && cat.children.length > 0) {
+                    const found = findCategoryById(cat.children, targetId);
+                    if (found)
+                        return found;
+                }
+            }
+            return null;
+        };
+        // 将单个分类ID转换为数组
+        const categoryIds = Array.isArray(categoryId) ? categoryId : [categoryId];
+        // 收集所有指定分类下的产品ID
+        const allProductIds = [];
+        categoryIds.forEach(id => {
+            const targetCategory = findCategoryById(categories, id);
+            if (targetCategory) {
+                allProductIds.push(...targetCategory.productIds);
+            }
+        });
+        // 去重
+        const uniqueProductIds = [...new Set(allProductIds)];
+        if (uniqueProductIds.length === 0) {
+            return {
+                products: [],
+                total: 0,
+                page: options?.page || 1,
+                limit: options?.limit || 10
+            };
+        }
+        // 应用分页
+        const page = options?.page || 1;
+        const limit = options?.limit || 10;
+        const offset = (page - 1) * limit;
+        const paginatedProductIds = uniqueProductIds.slice(offset, offset + limit);
+        // 获取产品详情
+        const products = await Promise.all(paginatedProductIds.map(productId => this.getProduct_p(productId)));
+        // 应用状态过滤
+        let filteredProducts = products;
+        if (options?.status !== undefined) {
+            filteredProducts = products.filter(product => product.status === options.status);
+        }
+        return {
+            products: filteredProducts,
+            total: uniqueProductIds.length,
+            page,
+            limit
+        };
+    }
     /**
      * 5. 根据标签ID获取产品列表
      * 支持单个标签ID或标签ID数组
@@ -496,6 +691,96 @@ class ProductsAPI {
             limit
         };
     }
+    /**
+     * 5.1. 根据标签ID获取平台产品列表
+     */
+    async getProductsByTag_p(tagId, options) {
+        // 获取标签数据，传递productTagAlias参数
+        const tags = await this.getTags_p(options?.productTagAlias);
+        // 将单个标签ID转换为数组
+        const tagIds = Array.isArray(tagId) ? tagId : [tagId];
+        // 收集所有指定标签下的产品ID
+        const allProductIds = [];
+        tagIds.forEach(id => {
+            const targetTag = tags.find(tag => tag.tagId === id);
+            if (targetTag) {
+                allProductIds.push(...targetTag.productIds);
+            }
+        });
+        // 去重
+        const uniqueProductIds = [...new Set(allProductIds)];
+        if (uniqueProductIds.length === 0) {
+            return {
+                products: [],
+                total: 0,
+                page: options?.page || 1,
+                limit: options?.limit || 10
+            };
+        }
+        // 应用分页
+        const page = options?.page || 1;
+        const limit = options?.limit || 10;
+        const offset = (page - 1) * limit;
+        const paginatedProductIds = uniqueProductIds.slice(offset, offset + limit);
+        // 获取产品详情
+        const products = await Promise.all(paginatedProductIds.map(productId => this.getProduct_p(productId)));
+        // 应用状态过滤
+        let filteredProducts = products;
+        if (options?.status !== undefined) {
+            filteredProducts = products.filter(product => product.status === options.status);
+        }
+        return {
+            products: filteredProducts,
+            total: uniqueProductIds.length,
+            page,
+            limit
+        };
+    }
+    /**
+      * 5.2. 根据标签ID获取平台产品列表
+      */
+    async getProductsByTag_t(tagId, options) {
+        // 获取标签数据，传递productTagAlias参数
+        const tags = await this.getTags(options?.productTagAlias);
+        // 将单个标签ID转换为数组
+        const tagIds = Array.isArray(tagId) ? tagId : [tagId];
+        // 收集所有指定标签下的产品ID
+        const allProductIds = [];
+        tagIds.forEach(id => {
+            const targetTag = tags.find(tag => tag.tagId === id);
+            if (targetTag) {
+                allProductIds.push(...targetTag.productIds);
+            }
+        });
+        // 去重
+        const uniqueProductIds = [...new Set(allProductIds)];
+        if (uniqueProductIds.length === 0) {
+            return {
+                products: [],
+                total: 0,
+                page: options?.page || 1,
+                limit: options?.limit || 10
+            };
+        }
+        // 应用分页
+        const page = options?.page || 1;
+        const limit = options?.limit || 10;
+        const offset = (page - 1) * limit;
+        const paginatedProductIds = uniqueProductIds.slice(offset, offset + limit);
+        // 获取产品详情
+        const products = await Promise.all(paginatedProductIds.map(productId => this.getProduct_p(productId)));
+        // 应用状态过滤
+        let filteredProducts = products;
+        if (options?.status !== undefined) {
+            filteredProducts = products.filter(product => product.status === options.status);
+        }
+        return {
+            products: filteredProducts,
+            total: uniqueProductIds.length,
+            page,
+            limit
+        };
+    }
     /**
      * 6. 根据分类ID获取该分类的层级路径
      * 用于前端面包屑导航
@@ -711,6 +996,16 @@ class SettingsAPI {
         const response = await this.client.request(`/settings/platform-${config.platformId}-${alias}.json`);
         return response.settings;
     }
+    /**
+     * 获取平台全局设置列表
+     * 根据平台ID和别名获取所有全局设置
+     */
+    async getSettings_p(settingAlias_p) {
+        const config = this.client.getConfig();
+        const alias = settingAlias_p || config.settingAlias_p || '01';
+        const response = await this.client.request(`/settings/platform-${config.platformId_p}-${alias}.json`);
+        return response.settings;
+    }
     /**
      * 获取指定设置
      * 根据设置key直接获取单个设置
@@ -726,6 +1021,21 @@ class SettingsAPI {
             return null;
         }
     }
+    /**
+     * 获取平台用户指定设置
+     * 根据设置key直接获取单个设置
+     */
+    async getSetting_p(key) {
+        const config = this.client.getConfig();
+        try {
+            const response = await this.client.request(`/settings/platform-${config.platformId_p}-${key}.json`);
+            return response.setting;
+        }
+        catch (error) {
+            console.warn(`Failed to fetch setting ${key}:`, error);
+            return null;
+        }
+    }
 }
 
 class FormsAPI {
@@ -2061,30 +2371,72 @@ class GT6SDK {
     async getProduct(productId) {
         return this.products.getProduct(productId);
     }
+    /**
+     * 8.1. 便捷方法：根据产品ID获取父平台产品详情
+     */
+    async getProduct_p(productId) {
+        return this.products.getProduct_p(productId);
+    }
     /**
      * 9. 便捷方法：获取产品分类列表
      */
     async getProductCategories(productRootCategoryId) {
         return this.products.getCategories(productRootCategoryId);
     }
+    /**
+     * 9.1. 便捷方法：获取父平台产品分类列表
+     */
+    async getProductCategories_p(productRootCategoryId_p) {
+        return this.products.getCategories_p(productRootCategoryId_p);
+    }
     /**
      * 10. 便捷方法：获取产品标签列表
      */
     async getProductTags(productTagAlias) {
         return this.products.getTags(productTagAlias);
     }
+    /**
+     * 10.1. 便捷方法：获取父平台产品标签列表
+     */
+    async getProductTags_p(productTagAlias_p) {
+        return this.products.getTags_p(productTagAlias_p);
+    }
     /**
      * 11. 便捷方法：根据分类ID获取产品列表
      */
     async getProductsByCategory(categoryId, options) {
         return this.products.getProductsByCategory(categoryId, options);
     }
+    /**
+     * 11.1. 便捷方法：根据分类ID获取父平台产品列表
+     */
+    async getProductsByCategory_p(categoryId, options) {
+        return this.products.getProductsByCategory_p(categoryId, options);
+    }
+    /**
+     * 11.2. 便捷方法：根据分类ID获取父平台产品列表（使用当前分类数据）
+     */
+    async getProductsByCategory_t(categoryId, options) {
+        return this.products.getProductsByCategory_t(categoryId, options);
+    }
     /**
      * 12. 便捷方法：根据标签ID获取产品列表
      */
     async getProductsByTag(tagId, options) {
         return this.products.getProductsByTag(tagId, options);
     }
+    /**
+     * 12.1. 便捷方法：根据标签ID获取父平台产品列表
+     */
+    async getProductsByTag_p(tagId, options) {
+        return this.products.getProductsByTag_p(tagId, options);
+    }
+    /**
+     * 12.2. 便捷方法：根据标签ID获取父平台产品列表（使用当前标签数据）
+     */
+    async getProductsByTag_t(tagId, options) {
+        return this.products.getProductsByTag_t(tagId, options);
+    }
     /**
      * 13. 便捷方法：根据分类ID获取该分类的层级路径
      */
@@ -2121,12 +2473,24 @@ class GT6SDK {
     async getSettings(settingAlias) {
         return this.settings.getSettings(settingAlias);
     }
+    /**
+     * 18.1. 便捷方法：获取父平台全局设置列表
+     */
+    async getSettings_p(settingAlias_p) {
+        return this.settings.getSettings_p(settingAlias_p);
+    }
     /**
      * 19. 便捷方法：获取指定设置
      */
     async getSetting(key) {
         return this.settings.getSetting(key);
     }
+    /**
+     * 19.1. 便捷方法：获取父平台指定设置
+     */
+    async getSetting_p(key) {
+        return this.settings.getSetting_p(key);
+    }
     /**
      * 20. 便捷方法：获取支付方式列表
      */