@gt6/sdk 1.0.24 → 1.0.25

package/dist/gt6-sdk.esm.js

@@ -103,6 +103,12 @@ class ArticlesAPI {
     async getArticle(articleId) {
         return this.client.request(`/articles/${articleId}.json`);
     }
+    /**
+     * 1.1 根据文章ID获取文章详情（使用上级平台ID）
+     */
+    async getArticle_p(articleId) {
+        return this.client.request(`/parentarticles/${articleId}.json`);
+    }
     /**
      * 2. 获取文章分类列表
      */
@@ -112,6 +118,15 @@ class ArticlesAPI {
         const response = await this.client.request(`/article-categories/platform-${config.platformId}-root-${categoryId}.json`);
         return response.categories;
     }
+    /**
+     * 2.1 获取文章分类列表（使用下级平台ID）
+     */
+    async getCategories_p(rootCategoryId_p) {
+        const config = this.client.getConfig();
+        const categoryId = rootCategoryId_p || config.rootCategoryId_p || '671920';
+        const response = await this.client.request(`/article-categories/platform-${config.platformId_p}-root-${categoryId}.json`);
+        return response.categories;
+    }
     /**
      * 3. 获取文章标签列表
      */
@@ -121,6 +136,15 @@ class ArticlesAPI {
         const response = await this.client.request(`/article-tags/platform-${config.platformId}-${alias}.json`);
         return response.tags;
     }
+    /**
+     * 3.1 获取文章标签列表（使用下级平台ID）
+     */
+    async getTags_p(tagAlias_p) {
+        const config = this.client.getConfig();
+        const alias = tagAlias_p || config.tagAlias_p || '001';
+        const response = await this.client.request(`/article-tags/platform-${config.platformId_p}-${alias}.json`);
+        return response.tags;
+    }
     /**
      * 4. 根据分类ID获取文章列表
      * 支持单个分类ID或分类ID数组
@@ -167,6 +191,98 @@ class ArticlesAPI {
             limit
         };
     }
+    /**
+     * 4.1 根据分类ID获取文章列表
+     * 支持单个分类ID或分类ID数组
+     */
+    async getArticlesByCategory_p(categoryId, options) {
+        // 获取分类数据
+        const categories = await this.getCategories_p();
+        // 将单个分类ID转换为数组
+        const categoryIds = Array.isArray(categoryId) ? categoryId : [categoryId];
+        // 收集所有指定分类下的文章ID
+        const allArticleIds = [];
+        categoryIds.forEach(id => {
+            const targetCategory = categories.find(cat => cat.categoryId === id);
+            if (targetCategory) {
+                allArticleIds.push(...targetCategory.articleIds);
+            }
+        });
+        // 去重
+        const uniqueArticleIds = [...new Set(allArticleIds)];
+        if (uniqueArticleIds.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 = uniqueArticleIds.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);
+        }
+        return {
+            articles: filteredArticles,
+            total: uniqueArticleIds.length,
+            page,
+            limit
+        };
+    }
+    /**
+     * 4.2 根据分类ID获取文章列表
+     * 支持单个分类ID或分类ID数组
+     */
+    async getArticlesByCategory_t(categoryId, options) {
+        // 获取分类数据
+        const categories = await this.getCategories();
+        // 将单个分类ID转换为数组
+        const categoryIds = Array.isArray(categoryId) ? categoryId : [categoryId];
+        // 收集所有指定分类下的文章ID
+        const allArticleIds = [];
+        categoryIds.forEach(id => {
+            const targetCategory = categories.find(cat => cat.categoryId === id);
+            if (targetCategory) {
+                allArticleIds.push(...targetCategory.articleIds);
+            }
+        });
+        // 去重
+        const uniqueArticleIds = [...new Set(allArticleIds)];
+        if (uniqueArticleIds.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 = uniqueArticleIds.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);
+        }
+        return {
+            articles: filteredArticles,
+            total: uniqueArticleIds.length,
+            page,
+            limit
+        };
+    }
     /**
      * 5. 根据标签ID获取文章列表
      * 支持单个标签ID或标签ID数组
@@ -213,6 +329,98 @@ class ArticlesAPI {
             limit
         };
     }
+    /**
+     * 5.1 根据标签ID获取文章列表
+     * 支持单个标签ID或标签ID数组
+     */
+    async getArticlesByTag_p(tagId, options) {
+        // 获取标签数据，传递tagAlias参数
+        const tags = await this.getTags_p(options?.tagAlias);
+        // 将单个标签ID转换为数组
+        const tagIds = Array.isArray(tagId) ? tagId : [tagId];
+        // 收集所有指定标签下的文章ID
+        const allArticleIds = [];
+        tagIds.forEach(id => {
+            const targetTag = tags.find(tag => tag.tagId === id);
+            if (targetTag) {
+                allArticleIds.push(...targetTag.articleIds);
+            }
+        });
+        // 去重
+        const uniqueArticleIds = [...new Set(allArticleIds)];
+        if (uniqueArticleIds.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 = uniqueArticleIds.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);
+        }
+        return {
+            articles: filteredArticles,
+            total: uniqueArticleIds.length,
+            page,
+            limit
+        };
+    }
+    /**
+     * 5.2 根据标签ID获取文章列表
+     * 支持单个标签ID或标签ID数组
+     */
+    async getArticlesByTag_t(tagId, options) {
+        // 获取标签数据，传递tagAlias参数
+        const tags = await this.getTags(options?.tagAlias);
+        // 将单个标签ID转换为数组
+        const tagIds = Array.isArray(tagId) ? tagId : [tagId];
+        // 收集所有指定标签下的文章ID
+        const allArticleIds = [];
+        tagIds.forEach(id => {
+            const targetTag = tags.find(tag => tag.tagId === id);
+            if (targetTag) {
+                allArticleIds.push(...targetTag.articleIds);
+            }
+        });
+        // 去重
+        const uniqueArticleIds = [...new Set(allArticleIds)];
+        if (uniqueArticleIds.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 = uniqueArticleIds.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);
+        }
+        return {
+            articles: filteredArticles,
+            total: uniqueArticleIds.length,
+            page,
+            limit
+        };
+    }
     /**
      * 6. 根据分类ID获取该分类的层级路径
      * 用于前端面包屑导航
@@ -2329,30 +2537,72 @@ class GT6SDK {
     async getArticle(articleId) {
         return this.articles.getArticle(articleId);
     }
+    /**
+     * 1.1. 便捷方法：根据文章ID获取文章详情（使用上级平台ID）
+     */
+    async getArticle_p(articleId) {
+        return this.articles.getArticle_p(articleId);
+    }
     /**
      * 2. 便捷方法：获取文章分类列表
      */
     async getCategories(rootCategoryId) {
         return this.articles.getCategories(rootCategoryId);
     }
+    /**
+     * 2.1. 便捷方法：获取文章分类列表（使用下级平台ID）
+     */
+    async getCategories_p(rootCategoryId_p) {
+        return this.articles.getCategories_p(rootCategoryId_p);
+    }
     /**
      * 3. 便捷方法：获取文章标签列表
      */
     async getTags(tagAlias) {
         return this.articles.getTags(tagAlias);
     }
+    /**
+     * 3.1. 便捷方法：获取文章标签列表（使用下级平台ID）
+     */
+    async getTags_p(tagAlias_p) {
+        return this.articles.getTags_p(tagAlias_p);
+    }
     /**
      * 4. 便捷方法：根据分类ID获取文章列表
      */
     async getArticlesByCategory(categoryId, options) {
         return this.articles.getArticlesByCategory(categoryId, options);
     }
+    /**
+     * 4.1. 便捷方法：根据分类ID获取文章列表（使用下级平台ID）
+     */
+    async getArticlesByCategory_p(categoryId, options) {
+        return this.articles.getArticlesByCategory_p(categoryId, options);
+    }
+    /**
+     * 4.2. 便捷方法：根据分类ID获取文章列表（使用当前分类数据）
+     */
+    async getArticlesByCategory_t(categoryId, options) {
+        return this.articles.getArticlesByCategory_t(categoryId, options);
+    }
     /**
      * 5. 便捷方法：根据标签ID获取文章列表
      */
     async getArticlesByTag(tagId, options) {
         return this.articles.getArticlesByTag(tagId, options);
     }
+    /**
+     * 5.1. 便捷方法：根据标签ID获取文章列表（使用下级平台ID）
+     */
+    async getArticlesByTag_p(tagId, options) {
+        return this.articles.getArticlesByTag_p(tagId, options);
+    }
+    /**
+     * 5.2. 便捷方法：根据标签ID获取文章列表（使用当前标签数据）
+     */
+    async getArticlesByTag_t(tagId, options) {
+        return this.articles.getArticlesByTag_t(tagId, options);
+    }
     /**
      * 6. 便捷方法：根据分类ID获取该分类的层级路径
      */