@ccw-api/api 0.3.1 → 0.4.1

package/README.md

@@ -40,9 +40,9 @@ setToken("abcdefgfoo");
 ### 2. 调用方式
 
 ```ts
-import { sso, communityWeb } from "@ccw-api/api"; // ✅ 推荐：具名导入
+import { sso, communityWeb, gandiMain, bfsWeb } from "@ccw-api/api"; // ✅ 推荐：具名导入
 // 或
-import api from "@ccw-api/api"; // ✅ default 导入：api.sso / api.communityWeb
+import api from "@ccw-api/api"; // ✅ default 导入：api.sso / api.communityWeb / api.gandiMain / api.bfsWeb
 ```
 
 ---
@@ -71,7 +71,7 @@ await logoutBySession("64...session_oid");
 
 ## 模块二：Community-Web（community-web.ccw.site）
 
-覆盖作品 / 学生 / 星球 / 评论 / 通知 / 任务 / 表情 / 签到 / 云资产 / 学科专区 等业务领域，共 **68 个 API**。
+覆盖作品 / 学生 / 星球 / 评论 / 通知 / 任务 / 表情 / 签到 / 云资产 / 学科专区 等业务领域，共 **95 个 API**。
 下面是常用场景示例。
 
 ### 学生与作品
@@ -200,6 +200,48 @@ const locked = await communityWeb.getLockedUserDetail<true>(
 const muted = await communityWeb.getMutedUserDetail("244373873");
 ```
 
+---
+
+## 模块三：Gandi-Main（gandi-main.ccw.site）
+
+公告与服务器时间相关，共 **3 个 API**：
+
+```ts
+const { getCurrentTimestamp, getBulletinsPage, getBulletinDetail } = gandiMain;
+
+// 服务端当前毫秒级时间戳（比客户端时间更可靠，可用于签到、排行榜等需要严格时间判断的场景）
+const ts = await gandiMain.getCurrentTimestamp();
+
+// 分页拉取公告列表（默认按 publishedAt 倒序，过滤已发布）
+const bulletins = await gandiMain.getBulletinsPage("PUBLISHED", {
+  page: 1,
+  perPage: 10,
+});
+// bulletins.data[0].title / id / publishedAt
+
+// 某条公告详情
+const detail = await gandiMain.getBulletinDetail(123);
+```
+
+---
+
+## 模块四：BFS-Web（bfs-web.ccw.site）
+
+用户扩展（extension）管理，共 **1 个 API**：
+
+```ts
+const { getUserExtensions } = bfsWeb;
+
+// 分页查询某用户上传/使用过的扩展列表（默认按 updatedAt 倒序）
+const exts = await bfsWeb.getUserExtensions("63c2807d669fa967f17f5559", {
+  page: 1,
+  perPage: 20,
+});
+// exts: PagesRes<Extension>
+```
+
+---
+
 ### 通用工具型 API
 
 ```ts
@@ -271,7 +313,8 @@ type PlanetRank = Creation.HashTagCreationRank; // "ORDINARY"
 ```ts
 import type { PageArgs, PagesRes } from "@ccw-api/api";
 
-// 入参 Partial<PageArgs<SortField>>，默认 { page:1, perPage:20, sortType:"DESC" }
+// 入参 T extends string
+// Partial<PageArgs<SortField|T>>，默认 { page:1, perPage:20, sortType:"DESC" }
 // 出参 PagesRes<T> 完整结构：
 const p: PagesRes<Creation.Creation> = {
   data: [], // 当前页数据
@@ -293,7 +336,7 @@ const p: PagesRes<Creation.Creation> = {
 # 三产物构建（node / esm / .d.ts）
 npm run build
 
-# 跑测试（Jest 30 + ts-jest，67 suites / 72 tests）
+# 跑测试（Jest 30 + ts-jest，101 suites / 106 tests）
 npm test
 npm run test:dev       # watch 模式
 
@@ -310,7 +353,7 @@ npm run doc:dev
 
 所有 API 文件严格遵循 `AGENT.md` 规范：
 
-- **按域名分组**：`src/sso` / `src/community-web`，内部子目录对应 URL 路径
+- **按域名分组**：`src/sso` / `src/community-web` / `src/gandi-main` / `src/bfs-web`，内部子目录对应 URL 路径
 - **单文件单接口**：文件名 `kebab-case`，对应 endpoint 最后一段
 - **7 段式模板**（每个 API 文件内部固定顺序）：
   1. `import`
@@ -321,4 +364,4 @@ npm run doc:dev
   6. JSDoc（`@param` / `@returns`）
   7. `export async function xxx(): Promise<Res>`
 
-新增 API 时，**最后记得在 `src/community-web/index.ts` 里 `import + 对象字面量聚合导出`**，否则外部访问不到。
+新增 API 时，**最后记得在对应服务的 `index.ts`（如 `src/community-web/index.ts`、`src/gandi-main/index.ts` 等）里 `import + 对象字面量聚合导出`**，否则外部访问不到。

package/dist/esm/src/bfs-web/extensions/{eid}/donate.js

@@ -0,0 +1,14 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://bfs-web.ccw.site/extensions";
+/**
+ * 向扩展投币
+ * @param {ExtensionDonateEid} eid 扩展id
+ * @param {number} bucks 捐赠金币数量
+ * @returns {Promise<Res>} 是否捐赠成功
+ */
+export async function donateExtension(eid, bucks) {
+    const req = { eid, bucks };
+    return await ccwAxios
+        .post(`${url}/${eid}/donate`, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/bfs-web/extensions/{eid}/donate.test.js

@@ -0,0 +1,4 @@
+import { donateExtension } from "./donate";
+test("donate extension should fail without token", async () => {
+    await expect(donateExtension("spineAnimation", 1)).rejects.toThrow();
+});

package/dist/esm/src/bfs-web/index.js

@@ -0,0 +1,6 @@
+import { getUserExtensions } from "./users/{oid}/extensions";
+import { donateExtension } from "./extensions/{eid}/donate";
+export const bfsWeb = {
+    donateExtension,
+    getUserExtensions,
+};

package/dist/esm/src/bfs-web/users/{oid}/extensions.js

@@ -0,0 +1,21 @@
+import { ccwAxios } from "@ccw-api/axios";
+import { DEFAULT_PAGE_ARGS, queryPage } from "src/queryPages";
+export const url = "https://bfs-web.ccw.site/users";
+/**
+ * 获取用户扩展列表分页
+ * @param {MongoDBId} userOid 用户id
+ * @param {Partial<PageArgs<"createdAt" | "updatedAt" | T>>} pageArgs_ 分页参数
+ * @returns {Promise<Res>} 扩展分页列表
+ */
+export async function getUserExtensions(userOid, pageArgs_ = {
+    sortField: "updatedAt",
+}) {
+    const pageArgs = {
+        ...DEFAULT_PAGE_ARGS,
+        ...pageArgs_,
+    };
+    const queryUrl = queryPage(`${url}/${userOid}/extensions`, pageArgs);
+    return await ccwAxios
+        .get(queryUrl)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/bfs-web/users/{oid}/extensions.test.js

@@ -0,0 +1,4 @@
+import { getUserExtensions } from "./extensions";
+test("get user extensions should fail without token", async () => {
+    await expect(getUserExtensions("63c2807d669fa967f17f5559")).resolves.toHaveProperty("data");
+});

package/dist/esm/src/community-web/api/v1/short_code/encode.js

@@ -0,0 +1,25 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/api/v1/short_code/encode";
+/**
+ * 生成作品邀请码
+ * @param {MongoDBId} inviterId 邀请人id
+ * @param {CNameOssUrl} inviterAvatar 邀请人头像
+ * @param {string} inviterName 邀请人用户名
+ * @param {MongoDBId} creationOid 作品id
+ * @returns {Promise<Res>}
+ */
+export async function encodeShortCode(inviterId, inviterAvatar, inviterName, creationOid) {
+    const req = {
+        origin: {
+            inviterAvatar,
+            inviterName,
+            inviterId,
+            inviterType: "STUDENT",
+            entrance: "create_detail",
+            creationOid,
+        },
+    };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/api/v1/short_code/shortcode.test.js

@@ -0,0 +1,5 @@
+import { encodeShortCode } from "./encode";
+test("test shortcode", async () => {
+    const res = await encodeShortCode("63c2807d669fa967f17f5559", "https://m.ccw.site/user_projects_assets/244373873/3fc7886d05aed9f369d2c0bb2d677fc0.jpeg", "孟夫子驾到", "6386e11cfc1ed14684de07f8");
+    expect(res.code).toHaveLength("yZdXmD3PvwVPA30W".length);
+});

package/dist/esm/src/community-web/approval/approval.test.js

@@ -0,0 +1,5 @@
+import { getApprovalTags } from "./list";
+test("test approval list", async () => {
+    const tags = await getApprovalTags("63c2807d669fa967f17f5559");
+    expect(tags.find((v) => v.approvalTagId == 235).approvalTagName).toEqual("Gandi 开发者");
+});

package/dist/esm/src/community-web/approval/list.js

@@ -0,0 +1,16 @@
+import ccwAxios from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/approval/list";
+/**
+ * 获取特定用户的勋章数据
+ * @param {MongoDBId} studentOid 用户id
+ * @returns {Promise<Res<Tid, Tn>>} 勋章数据
+ */
+export async function getApprovalTags(studentOid) {
+    const req = {
+        objectId: studentOid,
+        objectType: "STUDENT",
+    };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/base/dateTime.js

@@ -0,0 +1,10 @@
+import ccwAxios from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/base/dateTime";
+/**
+ * @returns {Promise<number>} 当前时间戳,相当于Date.now()
+ */
+export async function getTime() {
+    return ccwAxios
+        .post(url, undefined)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/base/dateTime.test.js

@@ -0,0 +1,6 @@
+import { getTime } from "../base/dateTime";
+test("get time should return a number", async () => {
+    const time = await getTime();
+    expect(typeof time).toBe("number");
+    expect(time).toBeGreaterThan(0);
+});

package/dist/esm/src/community-web/campaign_resource/detail.js

@@ -0,0 +1,12 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/campaign_resource/detail";
+/**
+ * 不知道这个接口有什么用,请查看https://www.ccw.site/pages/tags自行寻找用法
+ * @param {K} keyword 活动关键词
+ * @returns {Promise<Res<K>>}
+ */
+export async function getCampaignResources(keyword) {
+    return await ccwAxios
+        .post(url, { keyword })
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/campaign_resource/detail.test.js

@@ -0,0 +1,10 @@
+import { getCampaignResources } from "./detail";
+test("get campaign resources with tags keyword", async () => {
+    const res = await getCampaignResources("tags");
+    expect(res.keyword).toBe("tags");
+    expect(res.resourceType).toBe("SUBJECT_AREA");
+});
+test("get campaign resources with mmo keyword", async () => {
+    const res = await getCampaignResources("mmo");
+    expect(res.keyword).toBe("mmo");
+});

package/dist/esm/src/community-web/ccw-main/status.js

@@ -0,0 +1,12 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/ccw-main/status";
+/**
+ * ccw-main/status
+ * @returns {Promise<Res>} 信息
+ */
+export async function getCCWMainStatus() {
+    const req = {};
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/ccw-main/status.test.js

@@ -0,0 +1,4 @@
+import { getCCWMainStatus } from "./status";
+test("get ccw main status should fail without token", async () => {
+    await expect(getCCWMainStatus()).rejects.toThrow("token为空");
+});

package/dist/esm/src/community-web/check_in_record/check_in_record.test.js

@@ -0,0 +1,8 @@
+import { getCheckInRecords } from "./detail";
+import { insertCheckInRecord } from "./insert";
+test("get check in records should fail without channel", async () => {
+    await expect(getCheckInRecords).rejects.toThrow("ccw axios Request failed: token为空(4001082401)");
+});
+test("insert check in record should fail without token", async () => {
+    await expect(insertCheckInRecord).rejects.toThrow("ccw axios Request failed: token为空(4001082401)");
+});

package/dist/esm/src/community-web/check_in_record/detail.js

@@ -0,0 +1,11 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/check_in_record/detail";
+/**
+ * 获取本月签到记录
+ */
+export async function getCheckInRecords() {
+    const req = { scene: "HOMEPAGE" };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/check_in_record/insert.js

@@ -0,0 +1,12 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/check_in_record/insert";
+/**
+ * 插入签到记录（相当于签到）
+ * @returns {Promise<boolean>} 是否成功
+ */
+export async function insertCheckInRecord() {
+    const req = { scene: "HOMEPAGE" };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/cloud_asset/search.js

@@ -0,0 +1,25 @@
+import { ccwAxios } from "@ccw-api/axios";
+import { DEFAULT_PAGE_ARGS, queryPage } from "src/queryPages";
+export const url = "https://community-web.ccw.site/cloud_asset/search";
+const dpa = {
+    ...DEFAULT_PAGE_ARGS,
+    sortField: "createdAt",
+};
+/**
+ * 获取用户云背包特定目录内素材
+ * @param {MongoDBId} creatorOid 用户id
+ * @param {string} path 目录(例如'/23azZqHBnqj/2BzzTdi5I5C/')
+ * @param {Partial<PageArgs<SortField | T>>} pageArgs_ 分页参数
+ * @returns {Promise<Res>} 目录内的素材分页结果
+ */
+export async function searchCloudAssets(creatorOid, path = "/", pageArgs_ = {}) {
+    const pageArgs = {
+        ...dpa,
+        ...pageArgs_,
+    };
+    const queryUrl = queryPage(url, pageArgs);
+    const req = { creatorOid, path };
+    return await ccwAxios
+        .post(queryUrl, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/cloud_asset/search.test.js

@@ -0,0 +1,6 @@
+import { searchCloudAssets } from "./search";
+test("search cloud assets should fail without token", async () => {
+    const userId = "63c2807d669fa967f17f5559";
+    const path = "/23azZqHBnqj/";
+    await expect(searchCloudAssets(userId, path)).rejects.toThrow("ccw axios Request failed: token为空(4001082401)");
+});

package/dist/esm/src/community-web/cloud_asset/user/privacy.js

@@ -0,0 +1,11 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/cloud_asset/user/privacy";
+/**
+ * 获取用户云存储空间信息
+ * @returns {Promise<Res>} 存储空间信息
+ */
+export async function getUserAssetStorageSize() {
+    return await ccwAxios
+        .post(url, {})
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/cloud_asset/user/privacy.test.js

@@ -0,0 +1,4 @@
+import { getUserAssetStorageSize } from "./privacy";
+test("get user asset storage size should fail without token", async () => {
+    await expect(getUserAssetStorageSize()).rejects.toThrow("ccw axios Request failed: token为空");
+});

package/dist/esm/src/community-web/comment/create.js

@@ -0,0 +1,16 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/comment/create";
+/**
+ * 创建评论
+ * @param {string} content 评论内容
+ * @param {MinimalTopicInfo} topic 主题信息
+ * @param {string} sectionType 板块类型
+ * @returns {Promise<Res>} 创建的评论
+ */
+export async function createComment(content, topic, sectionType) {
+    topic.outline ??= "foo";
+    const req = { content, topic, sectionType };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/comment/create.test.js

@@ -0,0 +1,13 @@
+import { createComment } from "./create";
+import { getPostDetail } from "../post/detail";
+let samplePost;
+beforeAll(async () => {
+    samplePost = await getPostDetail("0173b23d-139d-4c48-ad98-0aa17b5d3b60");
+}, 30000);
+test("create comment should fail without token", async () => {
+    await expect(createComment("test", {
+        outline: "a",
+        subjectOid: samplePost.oid,
+        subjectType: "POST",
+    }, "COMMENT")).rejects.toThrow("token为空");
+});

package/dist/esm/src/community-web/comment/like_record/create.js

@@ -0,0 +1,13 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/comment/like_record/create";
+/**
+ * 点赞评论
+ * @param {number} commentId 评论id
+ * @returns {Promise<Res>} 操作是否成功
+ */
+export async function likeComment(commentId) {
+    const req = { commentId };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/comment/like_record/create.test.js

@@ -0,0 +1,4 @@
+import { likeComment } from "./create";
+test("like comment should fail without token", async () => {
+    await expect(likeComment(1)).rejects.toThrow("token为空");
+});

package/dist/esm/src/community-web/comment/page.js

@@ -0,0 +1,24 @@
+import { ccwAxios } from "@ccw-api/axios";
+import { DEFAULT_PAGE_ARGS, queryPage } from "src/queryPages";
+export const url = "https://community-web.ccw.site/comment/page";
+/**
+ * 根据topicId获取评论的回复
+ * @param {number} topicId 话题id
+ * @param {number} parentId 父评论id
+ * @param {("PUBLISHED" | "FOLDED")[]} statuses 状态过滤
+ * @param {Partial<PageArgs<SortField|T>>} pageArgs_ 分页参数
+ * @returns {Promise<Res>} 评论分页结果
+ */
+export async function getCommentReplies(topicId, parentId, statuses = ["PUBLISHED", "FOLDED"], pageArgs_ = {
+    sortField: "createdAt",
+}) {
+    const pageArgs = {
+        ...DEFAULT_PAGE_ARGS,
+        ...pageArgs_,
+    };
+    const queryUrl = queryPage(url, pageArgs);
+    const req = { topicId, parentId, statuses };
+    return await ccwAxios
+        .post(queryUrl, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/comment/page.test.js

@@ -0,0 +1,15 @@
+import { getCommentReplies } from "./page";
+test("get comment replies should return data", async () => {
+    const topicId = 819086;
+    const parentId = 9611280;
+    const statuses = ["PUBLISHED", "FOLDED"];
+    const res = await getCommentReplies(topicId, parentId, statuses);
+    expect(Array.isArray(res.data)).toBe(true);
+    res.data.forEach((comment) => {
+        expect(comment.id).toBeDefined();
+        expect(comment.topicId).toBe(topicId);
+        expect(comment.parentId).toBe(parentId);
+        expect(comment.content).toBeDefined();
+        expect(["PUBLISHED", "FOLDED"]).toContain(comment.status);
+    });
+});

package/dist/esm/src/community-web/comment/page_by_topic.js

@@ -0,0 +1,28 @@
+import { ccwAxios } from "@ccw-api/axios";
+import { DEFAULT_PAGE_ARGS, queryPage } from "src/queryPages";
+export const url = "https://community-web.ccw.site/comment/page_by_topic";
+const dpa = {
+    ...DEFAULT_PAGE_ARGS,
+    sortField: "createdAt",
+};
+/**
+ * 根据主题获取评论列表
+ * @param {string} subjectOid 主题oid
+ * @param {SubjectType} subjectType 主题类型 (如: "POST")
+ * @param {string} sectionType 区块类型 (如: "COMMENT")
+ * @param {Partial<PageArgs<SortField| T>>} pageArgs_ 分页参数
+ * @returns {Promise<Res>} 评论分页结果
+ */
+export async function getCommentsByTopic(subjectOid, subjectType, sectionType, pageArgs_ = {
+    sortField: "createdAt",
+}) {
+    const pageArgs = {
+        ...dpa,
+        ...pageArgs_,
+    };
+    const queryUrl = queryPage(url, pageArgs);
+    const req = { subjectOid, subjectType, sectionType };
+    return await ccwAxios
+        .post(queryUrl, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/comment/page_by_topic.test.js

@@ -0,0 +1,13 @@
+import { getCommentsByTopic } from "./page_by_topic";
+test("get comments by topic should return data", async () => {
+    const subjectOid = "6a3c73a3b6c84711978d92f2";
+    const subjectType = "POST";
+    const sectionType = "COMMENT";
+    const res = await getCommentsByTopic(subjectOid, subjectType, sectionType);
+    expect(Array.isArray(res.data)).toBe(true);
+    res.data.forEach((comment) => {
+        expect(comment.id).toBeDefined();
+        expect(comment.content).toBeDefined();
+        expect(["PUBLISHED", "FOLDED"]).toContain(comment.status);
+    });
+});

package/dist/esm/src/community-web/comment/reply.js

@@ -0,0 +1,17 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/comment/reply";
+/**
+ *回复评论
+ * @param content 回复内容
+ * @param replyToId 评论id
+ * @returns {Promise<Res>} 回复的评论
+ */
+export async function replyComment(content, replyToId) {
+    const req = {
+        content,
+        replyToId: `${replyToId}`,
+    };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/comment/reply.test.js

@@ -0,0 +1,4 @@
+import { replyComment } from "./reply";
+test("reply comment should fail without token", async () => {
+    await expect(replyComment("test reply", 1)).rejects.toThrow("token为空");
+});

package/dist/esm/src/community-web/config/detail.js

@@ -0,0 +1,13 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/config/detail";
+/**
+ * 获取配置详情
+ * @param {string} key 配置键
+ * @returns {Promise<Res>} 配置值
+ */
+export async function getConfigDetail(key) {
+    const req = { key };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/config/detail.test.js

@@ -0,0 +1,9 @@
+import { getConfigDetail } from "./detail";
+test("get config detail returns value without token", async () => {
+    const result = await getConfigDetail("foo");
+    expect(result === null ||
+        typeof result === "string" ||
+        typeof result === "number" ||
+        typeof result === "boolean" ||
+        typeof result === "object").toBe(true);
+});

package/dist/esm/src/community-web/creation/detail.js

@@ -0,0 +1,14 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/creation/detail";
+/**
+ * 获取作品详情
+ * @param {MongoDBId} oid 作品id
+ * @param {string} accessKey
+ * @returns {Promise<Creation>} 作品详情
+ */
+export async function getCreationDetail(oid, accessKey) {
+    const req = { oid, accessKey };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/creation/detail.test.js

@@ -0,0 +1,18 @@
+import { getCreationDetail } from "./detail";
+import { getExcellentCreations } from "./excellent/list";
+let sampleCreationOid;
+beforeAll(async () => {
+    const creations = await getExcellentCreations(1);
+    if (creations.length > 0) {
+        sampleCreationOid = creations[0].oid;
+    }
+}, 30000);
+test("get creation detail should return data", async () => {
+    if (!sampleCreationOid) {
+        return;
+    }
+    const res = await getCreationDetail(sampleCreationOid, "");
+    expect(res.oid).toBe(sampleCreationOid);
+    expect(res.title).toBeDefined();
+    expect(res.student).toBeDefined();
+});

package/dist/esm/src/community-web/creation/excellent/list.js

@@ -0,0 +1,13 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/creation/excellent/list";
+/**
+ * 获取精选作品列表
+ * @param {number} num 数量
+ * @returns {Promise<CreationSimple[]>} 作品列表
+ */
+export async function getExcellentCreations(num) {
+    const req = { num };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/src/community-web/creation/excellent/list.test.js

@@ -0,0 +1,10 @@
+import { getExcellentCreations } from "./list";
+test("get excellent creations should return data", async () => {
+    const res = await getExcellentCreations(15);
+    expect(Array.isArray(res)).toBe(true);
+    res.forEach((c) => {
+        expect(c.oid).toBeDefined();
+        expect(c.title).toBeDefined();
+    });
+    expect(res).toHaveLength(15);
+});

package/dist/esm/src/community-web/creation/introduction/detail.js

@@ -0,0 +1,13 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/creation/introduction/detail";
+/**
+ * 获取用户代表作
+ * @param {MongoDBId} studentOid 学生id
+ * @returns {Promise<Creation>} 作品详情
+ */
+export async function getCreationIntroduction(studentOid) {
+    const req = { studentOid };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}