@gt6/sdk 1.0.29 → 1.0.31

package/dist/gt6-sdk.esm.js

@@ -154,6 +154,25 @@ class ArticlesAPI {
         const response = await this.client.request(`/article-tags/platform-${config.platformId_p}-${alias}.json`);
         return response.tags;
     }
+    /**
+     * 3.2. 获取单个平台文章标签列表
+     */
+    async getTags_p_single(tagId_p) {
+        const config = this.client.getConfig();
+        const tagId = tagId_p || config.tagId_p;
+        if (!tagId) {
+            throw new Error('Article tag ID is required');
+        }
+        const response = await this.client.request(`/article-tags/${tagId}.json`);
+        return response;
+    }
+    /**
+     * 3.3. 获取单个平台文章标签的文章ID列表
+     */
+    async getTagArticleIds_p(tagId_p) {
+        const tagData = await this.getTags_p_single(tagId_p);
+        return tagData.articleIds;
+    }
     /**
      * 4. 根据分类ID获取文章列表
      * 支持单个分类ID或分类ID数组
@@ -464,6 +483,48 @@ class ArticlesAPI {
             limit
         };
     }
+    /**
+     * 5.3. 根据单个标签ID获取平台文章列表
+     * 使用getTags_p_single获取指定标签数据，然后获取文章详情
+     * @param tagId 单个标签ID
+     * @param options 查询选项
+     */
+    async getArticlesByTag_single(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_p(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
+        };
+    }
     /**
      * 6. 根据分类ID获取该分类的层级路径
      * 用于前端面包屑导航
@@ -727,6 +788,25 @@ class ProductsAPI {
         const response = await this.client.request(`/product-tags/platform-${config.platformId_p}-${alias}.json`);
         return response.tags;
     }
+    /**
+    * 3.2. 获取单个平台产品标签列表
+    */
+    async getTags_p_single(productTagId_p) {
+        const config = this.client.getConfig();
+        const productTagId = productTagId_p || config.productTagId_p;
+        if (!productTagId) {
+            throw new Error('Product tag ID is required');
+        }
+        const response = await this.client.request(`/product-tags/${productTagId}.json`);
+        return response;
+    }
+    /**
+     * 3.3. 获取单个平台产品标签的产品ID列表
+     */
+    async getTagProductIds_p(productTagId_p) {
+        const tagData = await this.getTags_p_single(productTagId_p);
+        return tagData.productIds;
+    }
     /**
      * 4. 根据分类ID获取产品列表
      * 支持单个分类ID或分类ID数组
@@ -907,12 +987,15 @@ class ProductsAPI {
     }
     /**
      * 4.3. 根据大分类ID获取平台产品列表
-     * 先从big-product-categories/${categoryId}.json获取产品ID，再分页后用getProduct_p获取详情
+     * 适配big-product-categories/${categoryId}.json新结构，支持排序和分页，直接返回数据
+     * @param categoryId 分类ID
+     * @param options { page, limit, sortBy }
+     *   sortBy: 'createdAt-desc' | 'createdAt-asc' | 'price-desc' | 'price-asc'
      */
     async getProductsByCategory_b(categoryId, options) {
-        // 从大型分类静态文件获取该分类的产品ID列表
+        // 从大型分类静态文件获取该分类的产品信息列表
         const categoryData = await this.client.request(`/big-product-categories/${categoryId}.json`);
-        if (!categoryData || !categoryData.productIds || categoryData.productIds.length === 0) {
+        if (!categoryData || !categoryData.productInfos || categoryData.productInfos.length === 0) {
             return {
                 products: [],
                 total: 0,
@@ -920,21 +1003,34 @@ class ProductsAPI {
                 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 paginatedProductIds = categoryData.productIds.slice(offset, offset + limit);
-        // 获取产品详情（使用上级平台数据）
-        const products = await Promise.all(paginatedProductIds.map(productId => this.getProduct_p(productId)));
-        // 应用状态过滤
-        let filteredProducts = products;
+        const paginatedProducts = sortedProducts.slice(offset, offset + limit);
+        // 应用状态过滤（如果有status字段）
+        let filteredProducts = paginatedProducts;
         if (options?.status !== undefined) {
-            filteredProducts = products.filter(product => product.status === options.status);
+            filteredProducts = paginatedProducts.filter(product => product.status === options.status);
         }
         return {
             products: filteredProducts,
-            total: categoryData.productIds.length,
+            total: categoryData.productInfos.length,
             page,
             limit
         };
@@ -1075,6 +1171,48 @@ class ProductsAPI {
             limit
         };
     }
+    /**
+     * 5.3. 根据单个标签ID获取平台产品列表
+     * 使用getTags_p_single获取指定标签数据，然后获取产品详情
+     * @param tagId 单个标签ID
+     * @param options 查询选项
+     */
+    async getProductsByTag_single(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_p(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
+        };
+    }
     /**
      * 6. 根据分类ID获取该分类的层级路径
      * 用于前端面包屑导航
@@ -2659,6 +2797,18 @@ class GT6SDK {
     async getTags_p(tagAlias_p) {
         return this.articles.getTags_p(tagAlias_p);
     }
+    /**
+     * 3.2. 便捷方法：获取单个平台文章标签列表
+     */
+    async getTags_p_single(tagId_p) {
+        return this.articles.getTags_p_single(tagId_p);
+    }
+    /**
+     * 3.3. 便捷方法：获取单个平台文章标签的文章ID列表
+     */
+    async getTagArticleIds_p(tagId_p) {
+        return this.articles.getTagArticleIds_p(tagId_p);
+    }
     /**
      * 4. 便捷方法：根据分类ID获取文章列表
      */
@@ -2701,6 +2851,12 @@ class GT6SDK {
     async getArticlesByTag_t(tagId, options) {
         return this.articles.getArticlesByTag_t(tagId, options);
     }
+    /**
+     * 5.3. 便捷方法：根据单个标签ID获取平台文章列表
+     */
+    async getArticlesByTag_single(tagId, options) {
+        return this.articles.getArticlesByTag_single(tagId, options);
+    }
     /**
      * 6. 便捷方法：根据分类ID获取该分类的层级路径
      */
@@ -2755,6 +2911,18 @@ class GT6SDK {
     async getProductTags_p(productTagAlias_p) {
         return this.products.getTags_p(productTagAlias_p);
     }
+    /**
+     * 10.2. 便捷方法：获取单个平台产品标签列表
+     */
+    async getProductTags_p_single(productTagId_p) {
+        return this.products.getTags_p_single(productTagId_p);
+    }
+    /**
+     * 10.3. 便捷方法：获取单个平台产品标签的产品ID列表
+     */
+    async getProductTagProductIds_p(productTagId_p) {
+        return this.products.getTagProductIds_p(productTagId_p);
+    }
     /**
      * 11. 便捷方法：根据分类ID获取产品列表
      */
@@ -2797,6 +2965,12 @@ class GT6SDK {
     async getProductsByTag_t(tagId, options) {
         return this.products.getProductsByTag_t(tagId, options);
     }
+    /**
+     * 12.3. 便捷方法：根据单个标签ID获取平台产品列表
+     */
+    async getProductsByTag_single(tagId, options) {
+        return this.products.getProductsByTag_single(tagId, options);
+    }
     /**
      * 13. 便捷方法：根据分类ID获取该分类的层级路径
      */