@gt6/sdk 1.0.36 → 1.0.38

package/dist/gt6-sdk.esm.js

@@ -619,6 +619,96 @@ class ArticlesAPI {
             depth: actualDepth
         };
     }
+    /******************************************************************************************
+     * 1.1 根据文章ID获取文章详情（平台用户都可以使用）
+     */
+    async getArticle_all(articleId) {
+        return this.client.request(`/articles_all/${articleId}.json`);
+    }
+    /**
+     * 1.2 根据分类ID获取文章列表（平台用户都可以使用）
+     */
+    async getArticlesByCategory_all(categoryId, options) {
+        // 从大型分类静态文件获取该分类的文章ID列表
+        const categoryData = await this.client.request(`/big-article-categories/${categoryId}.json`);
+        if (!categoryData || !categoryData.articleIds || categoryData.articleIds.length === 0) {
+            return {
+                articles: [],
+                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 paginatedArticleIds = categoryData.articleIds.slice(offset, offset + limit);
+        // 获取文章详情
+        const articles = await Promise.all(paginatedArticleIds.map(articleId => this.getArticle_all(articleId)));
+        // 应用状态过滤
+        let filteredArticles = articles;
+        if (options?.status) {
+            filteredArticles = articles.filter(article => article.status === options.status);
+        }
+        return {
+            articles: filteredArticles,
+            total: categoryData.articleIds.length,
+            page,
+            limit
+        };
+    }
+    /**
+     * 1.3 获取文章分类列表（平台用户都可以使用）
+     */
+    async getArticlesCategories_all(rootCategoryId) {
+        const config = this.client.getConfig();
+        const categoryId = rootCategoryId || config.rootCategoryId;
+        const response = await this.client.request(`/big-article-categories/platform-${config.platformId}-root-${categoryId}.json`);
+        return response.categories;
+    }
+    /**
+     * 1.4 根据单个标签ID获取平台文章列表
+     * 使用getTags_p_single获取指定标签数据，然后获取文章详情
+     * @param tagId 单个标签ID
+     * @param options 查询选项
+     */
+    async getArticlesByTag_single_all(tagId, options) {
+        // 获取指定标签的数据
+        const tagData = await this.getTags_p_single(tagId);
+        if (!tagData || !tagData.articleIds || tagData.articleIds.length === 0) {
+            // 剔除articleIds字段
+            const { articleIds, ...tagInfo } = tagData;
+            return {
+                articles: [],
+                total: 0,
+                page: options?.page || 1,
+                limit: options?.limit || 10,
+                tag: tagInfo
+            };
+        }
+        // 应用分页
+        const page = options?.page || 1;
+        const limit = options?.limit || 10;
+        const offset = (page - 1) * limit;
+        const paginatedArticleIds = tagData.articleIds.slice(offset, offset + limit);
+        // 获取文章详情
+        const articles = await Promise.all(paginatedArticleIds.map(articleId => this.getArticle_all(articleId)));
+        // 应用状态过滤
+        let filteredArticles = articles;
+        if (options?.status) {
+            filteredArticles = articles.filter(article => article.status === options.status);
+        }
+        // 剔除articleIds字段
+        const { articleIds, ...tagInfo } = tagData;
+        return {
+            articles: filteredArticles,
+            total: tagData.articleIds.length,
+            page,
+            limit,
+            tag: tagInfo
+        };
+    }
 }
 
 class ProductsAPI {
@@ -743,65 +833,6 @@ class ProductsAPI {
         }
         return product;
     }
-    /**
-    * 1.2. 根据产品ID全部产品详情（包括自定义和平台）
-    */
-    async getProduct_all(productId) {
-        const product = await this.client.request(`/products_all/${productId}.json`);
-        // 检查产品是否有销售区域和税费模板
-        if (product.regions_Parent && product.regions_Parent.length > 0 &&
-            product.taxTemplates && product.taxTemplates.length > 0) {
-            try {
-                // 获取税费信息
-                const taxInfo = await this.getTaxInfo01(product.platformId);
-                // 为每个税费模板添加规则
-                product.taxTemplates = product.taxTemplates.map(template => {
-                    const matchingTemplate = taxInfo.templates.find(t => t.templateId === template.templateId);
-                    if (matchingTemplate) {
-                        // 过滤出产品可销售区域的规则
-                        const productRegionIds = product.regions_Parent.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_Parent && product.regions_Parent.length > 0 &&
-            product.shippingTemplates && product.shippingTemplates.length > 0) {
-            try {
-                // 获取运费信息
-                const shippingInfo = await this.getShippingInfo01(product.platformId);
-                // 为每个运费模板添加规则
-                product.shippingTemplates = product.shippingTemplates.map(template => {
-                    const matchingTemplate = shippingInfo.templates.find(t => t.templateId === template.templateId);
-                    if (matchingTemplate) {
-                        // 过滤出产品可销售区域的规则
-                        const productRegionIds = product.regions_Parent.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. 获取产品分类列表
      */
@@ -1477,6 +1508,166 @@ class ProductsAPI {
         const attribute = method.attrs.find(attr => attr.attrName === attrName);
         return attribute ? attribute.attrValue : null;
     }
+    /******************************************************************************************
+     * 1.1 根据产品ID获取产品详情（平台用户都可以使用）
+     */
+    async getProduct_all(productId) {
+        const product = await this.client.request(`/products_all/${productId}.json`);
+        // 检查产品是否有销售区域和税费模板
+        if (product.regions_Parent && product.regions_Parent.length > 0 &&
+            product.taxTemplates && product.taxTemplates.length > 0) {
+            try {
+                // 获取税费信息
+                const taxInfo = await this.getTaxInfo01(product.platformId);
+                // 为每个税费模板添加规则
+                product.taxTemplates = product.taxTemplates.map(template => {
+                    const matchingTemplate = taxInfo.templates.find(t => t.templateId === template.templateId);
+                    if (matchingTemplate) {
+                        // 过滤出产品可销售区域的规则
+                        const productRegionIds = product.regions_Parent.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_Parent && product.regions_Parent.length > 0 &&
+            product.shippingTemplates && product.shippingTemplates.length > 0) {
+            try {
+                // 获取运费信息
+                const shippingInfo = await this.getShippingInfo01(product.platformId);
+                // 为每个运费模板添加规则
+                product.shippingTemplates = product.shippingTemplates.map(template => {
+                    const matchingTemplate = shippingInfo.templates.find(t => t.templateId === template.templateId);
+                    if (matchingTemplate) {
+                        // 过滤出产品可销售区域的规则
+                        const productRegionIds = product.regions_Parent.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;
+    }
+    /**
+     * 1.2 获取平台产品分类列表
+     */
+    async getProductsCategories_all(productRootCategoryId) {
+        const config = this.client.getConfig();
+        const categoryId = productRootCategoryId || config.productRootCategoryId;
+        const response = await this.client.request(`/big-product-categories/platform-${config.platformId}-root-${categoryId}.json`);
+        return response.categories;
+    }
+    /**
+     * 1.3 根据大分类ID获取平台产品列表
+     * 适配big-product-categories/${categoryId}.json新结构，支持排序和分页，直接返回数据
+     * @param categoryId 分类ID
+     * @param options { page, limit, sortBy }
+     *   sortBy: 'createdAt-desc' | 'createdAt-asc' | 'price-desc' | 'price-asc'
+     */
+    async getProductsByCategory_all(categoryId, options) {
+        // 从大型分类静态文件获取该分类的产品信息列表
+        const categoryData = await this.client.request(`/big-product-categories/${categoryId}.json`);
+        if (!categoryData || !categoryData.productInfos || categoryData.productInfos.length === 0) {
+            return {
+                products: [],
+                total: 0,
+                page: options?.page || 1,
+                limit: options?.limit || 10
+            };
+        }
+        // 排序
+        let sortedProducts = [...categoryData.productInfos];
+        const sortBy = options?.sortBy || 'createdAt-desc';
+        if (sortBy === 'createdAt-desc') {
+            sortedProducts.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        }
+        else if (sortBy === 'createdAt-asc') {
+            sortedProducts.sort((a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime());
+        }
+        else if (sortBy === 'price-desc') {
+            sortedProducts.sort((a, b) => parseFloat(b.price) - parseFloat(a.price));
+        }
+        else if (sortBy === 'price-asc') {
+            sortedProducts.sort((a, b) => parseFloat(a.price) - parseFloat(b.price));
+        }
+        // 应用分页
+        const page = options?.page || 1;
+        const limit = options?.limit || 10;
+        const offset = (page - 1) * limit;
+        const paginatedProducts = sortedProducts.slice(offset, offset + limit);
+        // 应用状态过滤（如果有status字段）
+        let filteredProducts = paginatedProducts;
+        if (options?.status !== undefined) {
+            filteredProducts = paginatedProducts.filter(product => product.status === options.status);
+        }
+        return {
+            products: filteredProducts,
+            total: categoryData.productInfos.length,
+            page,
+            limit
+        };
+    }
+    /**
+   * 1.4 根据单个标签ID获取平台产品列表
+   * 使用getTags_p_single获取指定标签数据，然后获取产品详情
+   * @param tagId 单个标签ID
+   * @param options 查询选项
+   */
+    async getProductsByTag_single_all(tagId, options) {
+        // 获取指定标签的数据
+        const tagData = await this.getTags_p_single(tagId);
+        if (!tagData || !tagData.productIds || tagData.productIds.length === 0) {
+            // 剔除productIds字段
+            const { productIds, ...tagInfo } = tagData;
+            return {
+                products: [],
+                total: 0,
+                page: options?.page || 1,
+                limit: options?.limit || 10,
+                tag: tagInfo
+            };
+        }
+        // 应用分页
+        const page = options?.page || 1;
+        const limit = options?.limit || 10;
+        const offset = (page - 1) * limit;
+        const paginatedProductIds = tagData.productIds.slice(offset, offset + limit);
+        // 获取产品详情
+        const products = await Promise.all(paginatedProductIds.map(productId => this.getProduct_all(productId)));
+        // 应用状态过滤
+        let filteredProducts = products;
+        if (options?.status !== undefined) {
+            filteredProducts = products.filter(product => product.status === options.status);
+        }
+        // 剔除productIds字段
+        const { productIds, ...tagInfo } = tagData;
+        return {
+            products: filteredProducts,
+            total: tagData.productIds.length,
+            page,
+            limit,
+            tag: tagInfo
+        };
+    }
 }
 
 class SettingsAPI {
@@ -2880,8 +3071,32 @@ class GT6SDK {
     async getArticlesByCategory(categoryId, options) {
         return this.articles.getArticlesByCategory(categoryId, options);
     }
+    /*********************************************************************************************
+     * 4.1. 便捷方法：根据分类ID获取文章列表（使用上级平台ID）
+     */
+    async getArticlesByCategory_all(categoryId, options) {
+        return this.articles.getArticlesByCategory_all(categoryId, options);
+    }
     /**
-     * 4.1. 便捷方法：根据分类ID获取文章列表（使用下级平台ID）
+     * 4.2. 便捷方法：获取文章分类列表
+     */
+    async getArticlesCategories_all(rootCategoryId) {
+        return this.articles.getArticlesCategories_all(rootCategoryId);
+    }
+    /**
+     * 4.3. 便捷方法：根据单个标签ID获取平台文章列表
+     */
+    async getArticlesByTag_single_all(tagId, options) {
+        return this.articles.getArticlesByTag_single_all(tagId, options);
+    }
+    /**
+     * 4.4. 便捷方法：根据文章ID获取文章详情（使用上级平台ID）
+     */
+    async getArticle_all(articleId) {
+        return this.articles.getArticle_all(articleId);
+    }
+    /*********************************************************************************************
+     * 4.5. 便捷方法：根据分类ID获取文章列表（使用下级平台ID）
      */
     async getArticlesByCategory_p(categoryId, options) {
         return this.articles.getArticlesByCategory_p(categoryId, options);
@@ -2958,6 +3173,24 @@ class GT6SDK {
     async getCategories_b(rootCategoryId) {
         return this.products.getCategories_b(rootCategoryId);
     }
+    /**
+     * 8.1.2. 便捷方法：获取父平台产品分类列表
+     */
+    async getProductsCategories_all(productRootCategoryId) {
+        return this.products.getProductsCategories_all(productRootCategoryId);
+    }
+    /**
+     * 8.1.3. 便捷方法：根据大分类ID获取平台产品列表
+     */
+    async getProductsByCategory_all(categoryId, options) {
+        return this.products.getProductsByCategory_all(categoryId, options);
+    }
+    /**
+     * 8.1.4. 便捷方法：根据单个标签ID获取平台产品列表
+     */
+    async getProductsByTag_single_all(tagId, options) {
+        return this.products.getProductsByTag_single_all(tagId, options);
+    }
     /**
      * 9. 便捷方法：获取产品分类列表
      */