@ccw-api/api 0.4.1 → 0.5.0

package/README.md

@@ -1,7 +1,8 @@
 # @ccw-api/api
 
-CCW（创作社区）前后端接口 SDK，整合 `sso.ccw.site` 与 `community-web.ccw.site`
-两大服务的常用 API，提供完整的 TypeScript 类型与开箱即用的分页封装。
+CCW（创作社区）前后端接口 SDK，整合 `sso.ccw.site`、`community-web.ccw.site`、
+`gandi-main.ccw.site`、`bfs-web.ccw.site`、`community-web-cloud-database.ccw.site`
+五大服务的常用 API，提供完整的 TypeScript 类型与开箱即用的分页封装。
 
 - 包格式：**ESM + CJS + .d.ts 三产物**同时产出
 - 类型：所有请求 / 响应字段**强类型**，后端 key 固定约束（如 `MongoDBId`、`CNameOssUrl`、`UUID`）
@@ -40,9 +41,15 @@ setToken("abcdefgfoo");
 ### 2. 调用方式
 
 ```ts
-import { sso, communityWeb, gandiMain, bfsWeb } from "@ccw-api/api"; // ✅ 推荐：具名导入
+import {
+  sso,
+  communityWeb,
+  gandiMain,
+  bfsWeb,
+  communityWebCloudDatabase,
+} from "@ccw-api/api"; // ✅ 推荐：具名导入
 // 或
-import api from "@ccw-api/api"; // ✅ default 导入：api.sso / api.communityWeb / api.gandiMain / api.bfsWeb
+import api from "@ccw-api/api"; // ✅ default 导入：api.sso / api.communityWeb / api.gandiMain / api.bfsWeb / api.communityWebCloudDatabase
 ```
 
 ---
@@ -71,7 +78,7 @@ await logoutBySession("64...session_oid");
 
 ## 模块二：Community-Web（community-web.ccw.site）
 
-覆盖作品 / 学生 / 星球 / 评论 / 通知 / 任务 / 表情 / 签到 / 云资产 / 学科专区 等业务领域，共 **95 个 API**。
+覆盖作品 / 学生 / 星球 / 评论 / 通知 / 任务 / 表情 / 签到 / 云资产 / 学科专区 / 打赏 等业务领域，共 **96 个 API**。
 下面是常用场景示例。
 
 ### 学生与作品
@@ -178,6 +185,10 @@ const [allEmoji, emojiPage, categories] = await Promise.all([
 // 签到
 await communityWeb.insertCheckInRecord(); // 今日打卡
 const history = await communityWeb.getCheckInRecords();
+
+// 作品 / 评论 打赏（需要token，消耗账户金币）
+// 给某个作品打赏 1 金币（objectType 默认 "CREATION"）
+await communityWeb.donateTrade(1, "68ce4849811b737483bf7027", "CREATION");
 ```
 
 ### 黑名单、封禁、禁言查询
@@ -204,10 +215,16 @@ const muted = await communityWeb.getMutedUserDetail("244373873");
 
 ## 模块三：Gandi-Main（gandi-main.ccw.site）
 
-公告与服务器时间相关，共 **3 个 API**：
+公告、服务器时间与作品排行榜相关，共 **5 个 API**：
 
 ```ts
-const { getCurrentTimestamp, getBulletinsPage, getBulletinDetail } = gandiMain;
+const {
+  getCurrentTimestamp,
+  getBulletinsPage,
+  getBulletinDetail,
+  submitLeaderboardRecord,
+  getLeaderboardRecords,
+} = gandiMain;
 
 // 服务端当前毫秒级时间戳（比客户端时间更可靠，可用于签到、排行榜等需要严格时间判断的场景）
 const ts = await gandiMain.getCurrentTimestamp();
@@ -221,16 +238,37 @@ const bulletins = await gandiMain.getBulletinsPage("PUBLISHED", {
 
 // 某条公告详情
 const detail = await gandiMain.getBulletinDetail(123);
+
+// ====== 作品排行榜 ======
+
+// 获取排行榜记录（含榜单配置、当前用户排名、完整记录分页列表）
+const board = await gandiMain.getLeaderboardRecords("65a2314daa96bd09b5beae5a");
+console.log(board.title); // "总收益"
+console.log(board.scoreUnit); // "币"
+console.log(board.sortType); // "DESC"
+console.log(board.leaderboardRecordTotalNum); // 834
+console.log(board.curUserLeaderboardRecord?.ranking); // 139
+console.log(board.leaderboardRecords[0].ranking); // 1
+console.log(board.leaderboardRecords[0].score); // 排行榜最高分
+console.log(board.leaderboardRecords[0].user?.nickname); // 榜首昵称
+
+// 向排行榜提交分数记录（需要token：userOid必须对应当前登录用户）
+await gandiMain.submitLeaderboardRecord(
+  "65a2314daa96bd09b5beae5a", // 排行榜oid
+  1500, // 分数
+  "6a42413ccc79993c436d04b6", // 用户oid
+  "", // 扩展信息（可选）
+);
 ```
 
 ---
 
 ## 模块四：BFS-Web（bfs-web.ccw.site）
 
-用户扩展（extension）管理，共 **1 个 API**：
+用户扩展（extension）管理与扩展打赏，共 **2 个 API**：
 
 ```ts
-const { getUserExtensions } = bfsWeb;
+const { getUserExtensions, donateExtension } = bfsWeb;
 
 // 分页查询某用户上传/使用过的扩展列表（默认按 updatedAt 倒序）
 const exts = await bfsWeb.getUserExtensions("63c2807d669fa967f17f5559", {
@@ -238,6 +276,40 @@ const exts = await bfsWeb.getUserExtensions("63c2807d669fa967f17f5559", {
   perPage: 20,
 });
 // exts: PagesRes<Extension>
+
+// 给某个扩展打赏（需要token，消耗账户金币）
+await bfsWeb.donateExtension(
+  "spineAnimation", // 扩展id（eid）
+  5, // 打赏金币数量
+);
+```
+
+---
+
+## 模块五：Community-Web-Cloud-Database（community-web-cloud-database.ccw.site）
+
+作品 / 用户的云变量（键值对存储）管理，共 **2 个 API**：
+
+```ts
+const { saveProjectCloudVariable, saveUserCloudVariable } =
+  communityWebCloudDatabase;
+
+// 保存作品云变量（无需token，主键是作品id；value结构任意，泛型自动推导返回）
+const saved1 = await communityWebCloudDatabase.saveProjectCloudVariable(
+  "651c9a5142f8fb5ada70fad2",
+  "backup_65d31eaeb2ce1b785ebea87b_云时间",
+  { v: "2025-07-05T17:40:53.057+0800" },
+);
+// saved1: { v: string }
+//   ^? 泛型自动匹配 value 传入的结构
+
+// 保存用户云变量（需要token，主键内部自动为 userId 拼接 "-u" 后缀）
+const saved2 = await communityWebCloudDatabase.saveUserCloudVariable(
+  "68dddc63d28b025cb53fae25",
+  "256053228",
+  { key2: "0" },
+);
+// saved2: { key2: string }
 ```
 
 ---
@@ -336,7 +408,7 @@ const p: PagesRes<Creation.Creation> = {
 # 三产物构建（node / esm / .d.ts）
 npm run build
 
-# 跑测试（Jest 30 + ts-jest，101 suites / 106 tests）
+# 跑测试（Jest 30 + ts-jest，105 suites / 112 tests）
 npm test
 npm run test:dev       # watch 模式
 

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

@@ -3,7 +3,7 @@ export const url = "https://community-web.ccw.site/api/v1/short_code/encode";
 /**
  * 生成作品邀请码
  * @param {MongoDBId} inviterId 邀请人id
- * @param {CachedOssUrl} inviterAvatar 邀请人头像
+ * @param {CNameOssUrl} inviterAvatar 邀请人头像
  * @param {string} inviterName 邀请人用户名
  * @param {MongoDBId} creationOid 作品id
  * @returns {Promise<Res>}

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

@@ -1,5 +1,8 @@
 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

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

@@ -1,7 +1,7 @@
 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() {

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

@@ -6,11 +6,11 @@ const dpa = {
     sortField: "createdAt",
 };
 /**
- *
+ * 获取用户云背包特定目录内素材
  * @param {MongoDBId} creatorOid 用户id
  * @param {string} path 目录(例如'/23azZqHBnqj/2BzzTdi5I5C/')
- * @param {Partial<PageArgs>} pageArgs_ 分页参数
- * @returns {Promise<CloudAsset[]>} 目录内的素材
+ * @param {Partial<PageArgs<SortField | T>>} pageArgs_ 分页参数
+ * @returns {Promise<Res>} 目录内的素材分页结果
  */
 export async function searchCloudAssets(creatorOid, path = "/", pageArgs_ = {}) {
     const pageArgs = {
@@ -21,5 +21,5 @@ export async function searchCloudAssets(creatorOid, path = "/", pageArgs_ = {})
     const req = { creatorOid, path };
     return await ccwAxios
         .post(queryUrl, req)
-        .then((res) => res.data.body.data);
+        .then((res) => res.data.body);
 }

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

@@ -1,26 +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";
-const dpa = {
-    ...DEFAULT_PAGE_ARGS,
-    sortField: null,
-};
 /**
  * 根据topicId获取评论的回复
  * @param {number} topicId 话题id
  * @param {number} parentId 父评论id
  * @param {("PUBLISHED" | "FOLDED")[]} statuses 状态过滤
- * @param {Partial<PageArgs<SortField>>} pageArgs_ 分页参数
- * @returns {Promise<Comment[]>} 评论列表
+ * @param {Partial<PageArgs<SortField|T>>} pageArgs_ 分页参数
+ * @returns {Promise<Res>} 评论分页结果
  */
-export async function getCommentReplies(topicId, parentId, statuses = ["PUBLISHED", "FOLDED"], pageArgs_ = {}) {
+export async function getCommentReplies(topicId, parentId, statuses = ["PUBLISHED", "FOLDED"], pageArgs_ = {
+    sortField: "createdAt",
+}) {
     const pageArgs = {
-        ...dpa,
+        ...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.data);
+        .then((res) => res.data.body);
 }

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

@@ -4,8 +4,8 @@ test("get comment replies should return data", async () => {
     const parentId = 9611280;
     const statuses = ["PUBLISHED", "FOLDED"];
     const res = await getCommentReplies(topicId, parentId, statuses);
-    expect(Array.isArray(res)).toBe(true);
-    res.forEach((comment) => {
+    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);

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

@@ -9,11 +9,13 @@ const dpa = {
  * 根据主题获取评论列表
  * @param {string} subjectOid 主题oid
  * @param {SubjectType} subjectType 主题类型 (如: "POST")
- * @param {string} sectionType 区块类型 (如: "COMMENT")
- * @param {Partial<PageArgs<SortField>>} pageArgs_ 分页参数
- * @returns {Promise<Comment[]>} 评论列表
+ * @param {SectionType} sectionType 区块类型 (如: "COMMENT")
+ * @param {Partial<PageArgs<SortField| T>>} pageArgs_ 分页参数
+ * @returns {Promise<Res>} 评论分页结果
  */
-export async function getCommentsByTopic(subjectOid, subjectType, sectionType, pageArgs_ = {}) {
+export async function getCommentsByTopic(subjectOid, subjectType, sectionType, pageArgs_ = {
+    sortField: "createdAt",
+}) {
     const pageArgs = {
         ...dpa,
         ...pageArgs_,
@@ -22,5 +24,5 @@ export async function getCommentsByTopic(subjectOid, subjectType, sectionType, p
     const req = { subjectOid, subjectType, sectionType };
     return await ccwAxios
         .post(queryUrl, req)
-        .then((res) => res.data.body.data);
+        .then((res) => res.data.body);
 }

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

@@ -4,8 +4,8 @@ test("get comments by topic should return data", async () => {
     const subjectType = "POST";
     const sectionType = "COMMENT";
     const res = await getCommentsByTopic(subjectOid, subjectType, sectionType);
-    expect(Array.isArray(res)).toBe(true);
-    res.forEach((comment) => {
+    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/community-web/creation/page.js

@@ -7,18 +7,18 @@ const dpa = {
 };
 /**
  * 根据原作品id获取改编作品分页列表
- * @param {MongoDBId[]} remixCreationOids 原作品id列表
- * @param {Partial<PageArgs<SortField>>} pageArgs_ 分页参数
- * @returns {Promise<CreationSimple[]>} 改编作品列表
+ * @param {MongoDBId[]} originCreationOids 原作品id列表
+ * @param {Partial<PageArgs<SortField | T>>} pageArgs_ 分页参数
+ * @returns {Promise<Res>} 改编作品分页结果
  */
-export async function getCreationPage(remixCreationOids, pageArgs_ = {}) {
+export async function getRemixedCreationPage(originCreationOids, pageArgs_ = {}) {
     const pageArgs = {
         ...dpa,
         ...pageArgs_,
     };
     const queryUrl = queryPage(url, pageArgs);
-    const req = { remixCreationOids };
+    const req = { remixCreationOids: originCreationOids };
     return await ccwAxios
         .post(queryUrl, req)
-        .then((res) => res.data.body.data);
+        .then((res) => res.data.body);
 }

package/dist/esm/community-web/creation/page_by_student.js

@@ -8,8 +8,8 @@ const dpa = {
 /**
  * 获取学生的作品列表
  * @param {MongoDBId[]} studentOids 学生id列表
- * @param {Partial<PageArgs<SortField>>} pageArgs_ 分页参数
- * @returns {Promise<Creation[]>} 作品列表
+ * @param {Partial<PageArgs<SortField|T>>} pageArgs_ 分页参数
+ * @returns {Promise<Res>} 作品分页结果
  */
 export async function getCreationsByStudent(studentOids, pageArgs_ = {}) {
     const pageArgs = {
@@ -20,5 +20,5 @@ export async function getCreationsByStudent(studentOids, pageArgs_ = {}) {
     const req = { studentOids };
     return await ccwAxios
         .post(queryUrl, req)
-        .then((res) => res.data.body.data);
+        .then((res) => res.data.body);
 }

package/dist/esm/community-web/creation/recommend.js

@@ -7,8 +7,8 @@ const dpa = {
 };
 /**
  * 获取推荐作品列表
- * @param {Partial<PageArgs<SortField>>} pageArgs_ 分页参数
- * @returns {Promise<CreationSimple[]>} 作品列表
+ * @param {Partial<PageArgs<SortField | T>>} pageArgs_ 分页参数
+ * @returns {Promise<Res>} 作品分页结果
  */
 export async function getRecommendCreations(num, pageArgs_ = {}) {
     const pageArgs = {
@@ -19,5 +19,5 @@ export async function getRecommendCreations(num, pageArgs_ = {}) {
     const req = { num, subjectType: "POTENTIAL" };
     return await ccwAxios
         .post(queryUrl, req)
-        .then((res) => res.data.body.data);
+        .then((res) => res.data.body);
 }

package/dist/esm/community-web/creation/search/page.js

@@ -6,19 +6,19 @@ const dpa = {
     sortField: "createdAt",
 };
 /**
- * 按标签搜索作品
- * @param {string} tag 标签 例如:游戏 动画故事 角色扮演
- * @param {Partial<PageArgs<SortField>>} pageArgs_ 分页参数
- * @returns {Promise<CreationSimple[]>} 作品列表
+ * 搜索作品
+ * @param {string} req.tag 标签 例如:游戏 动画故事 角色扮演 kukeChat
+ * @param {string[]} req.oids 作品id列表
+ * @param {Partial<PageArgs<SortField | T>>} pageArgs_ 分页参数
+ * @returns {Promise<Res>} 作品分页结果
  */
-export async function searchCreationsByTag(tag, pageArgs_ = {}) {
+export async function searchCreationsByTag(req, pageArgs_ = {}) {
     const pageArgs = {
         ...dpa,
         ...pageArgs_,
     };
     const queryUrl = queryPage(url, pageArgs);
-    const req = { tag };
     return await ccwAxios
         .post(queryUrl, req)
-        .then((res) => res.data.body.data);
+        .then((res) => res.data.body);
 }

package/dist/esm/community-web/great_creation/update.js

@@ -0,0 +1,13 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/great_creation/update";
+/**
+ * 更换代表作
+ * @param {MongoDBId|""} creationOid 作品OID 若为""则是取消展示
+ * @returns {Promise<Res>} 更换结果
+ */
+export async function updateGreatCreation(creationOid) {
+    const req = { creationOid };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/community-web/great_creation/update.test.js

@@ -0,0 +1,4 @@
+import { updateGreatCreation } from "./update";
+test("should fail without token when updating great creation", async () => {
+    await expect(updateGreatCreation("69740f1a61b891733d5ee2c6")).rejects.toThrow();
+});

package/dist/esm/community-web/index.js

@@ -14,7 +14,7 @@ import { getExcellentCreations } from "./creation/excellent/list";
 import { getCreationIntroduction } from "./creation/introduction/detail";
 import { getLikeDetail } from "./creation/like/detail";
 import { getLoadingTips } from "./creation/loading/tips";
-import { getCreationPage } from "./creation/page";
+import { getRemixedCreationPage } from "./creation/page";
 import { getCreationsByStudent } from "./creation/page_by_student";
 import { getPotentialCreations } from "./creation/potential/list";
 import { getRecommendCreations } from "./creation/recommend";
@@ -22,29 +22,179 @@ import { searchCreationsByTag } from "./creation/search/page";
 import { getCreationStudentDetail } from "./creation/student/detail";
 import { getCreationTags } from "./creation/tag/list";
 import { createShortUrl } from "./short_url/create";
+import { getPlanetsOfCreation } from "./hash_tag_creation/list_relation";
+import { getMyHashTagCreations } from "./hash_tag_creation/mine";
+import { getHashTagDetail } from "./hash_tag/detail";
+import { getManagedHashTags } from "./hash_tag/managed/list";
+import { getHashTagFavoriteDetail } from "./hash_tag_favorite/detail";
+import { getDonatedRecordRanking } from "./creation_donated_record/ranking_list";
+import { getCreationFavoriteDetail } from "./creation_favorite/detail";
+import { getCreationRecommendPositionList } from "./creation_recommend_position/list";
+import { getCreationScreenshotPage } from "./creation_screenshot/page";
+import { viewCreationStats } from "./creation_stats/view";
+import { getNotifyDeleteReasons } from "./notify_message/show";
+import { getPostDetail } from "./post/detail";
+import { getSearchHotWords } from "./search/hot_words";
+import { getStudentBlockRecordDetail } from "./student/block_record/detail";
+import { getStudentBlockRecordList } from "./student/block_record/list";
+import { getStudentBlockStatus } from "./student/block_record/status";
+import { getCreatorScore } from "./students/creator_score";
+import { getStudentLastActiveAt } from "./students/last_active_at";
+import { getStudentsList } from "./students/list";
+import { getStudentSessions } from "./students/list_sessions";
+import { getStudentProfile } from "./students/profile";
+import { getReputationScoreLog } from "./students/reputation_score_log/page";
+import { getStudentSelfDetail } from "./students/self/detail";
+import { getStudentStats } from "./students/stats";
+import { updateStudent } from "./students/update";
+import { getStudyCommunityMemberDetail } from "./study-community/member/detail";
+import { getSpreadFeedUnreadCount } from "./study-community/spread_feed/unread/count";
+import { getSubjectAreaPage } from "./subject_area/page";
+import { getSubjectAreaPageByChannel } from "./subject_area/page_by_channel";
+import { acceptAward } from "./task/award";
+import { getMyTasks } from "./task/mine";
+import { getUserCardDetail } from "./user-card/detail";
+import { getUserLabelList } from "./user_label/list";
+import { getPersonalCurrencyAccount } from "./currency/account/personal";
+import { getAllEmojis } from "./emoji/all";
+import { getEmojiCategoryList } from "./emoji/category/list";
+import { getEmojiPage } from "./emoji/page";
+import { sendEvent } from "./event";
+import { healthCheck } from "./health/check";
+import { getLeafletsItemList } from "./leaflets/item/list";
+import { getLockedUserDetail } from "./locked_user/detail";
+import { getMutedUserDetail } from "./muted_user/detail";
+import { getNotificationPage } from "./notification/page";
+import { getNotificationStats } from "./notification/stats/v2";
+import { getTypicalProjectPage } from "./typical_project/page";
+import { getTypicalProjectUnreadCount } from "./typical_project/student/unread_count";
+import { getOwnCreationPage } from "./creation/own/page";
+import { produceTeamMemberTicket } from "./creation/team_member/produce_ticket";
+import { getTeamMemberList } from "./creation/team_member/list";
+import { getTeamworkLogPage } from "./creation/teamwork_log/page";
+import { updateCreation } from "./creation/update";
+import { submitCreation } from "./creation/submit";
+import { getSplitRuleDetail } from "./creation/smart_contract/split_rule/detail";
+import { createSplitRule } from "./creation/smart_contract/split_rule/create";
+import { getCreationAttributeDetail } from "./creation_attribute/detail";
+import { getCreationActivityStatsList } from "./creation_activity_stats/list";
+import { getCreationReleasePage } from "./creation_release/page";
+import { getCodeProfilingDetail } from "./creation_release/code_profiling/detail";
+import { getHistoricalTeamMemberPage } from "./historical_team_member/page";
+import { decompressShortUrl } from "./short_url/decompress";
+import { getRecommendHashTags } from "./hash_tag/recommend/list";
+import { getCCWMainStatus } from "./ccw-main/status";
+import { createCloudVariable } from "./study-community/cloud_variable/create";
+import { topComment } from "./study-community/comment/top";
+import { foldComment } from "./study-community/comment/fold";
+import { resetCommentWeight } from "./study-community/comment/reset_weight";
+import { deleteComment } from "./study-community/comment/delete";
+import { createComment } from "./comment/create";
+import { likeComment } from "./comment/like_record/create";
+import { getStudentFollowingPage } from "./student/following/page";
+import { donateTrade } from "./study-trade/trade/donate";
+import { getUserProductsPage } from "./user_package/user_product";
+import { setUserProductStatus } from "./user_package/status";
+import { updateGreatCreation } from "./great_creation/update";
+import { getSmartContractList } from "./smart_contract/list";
 export const communityWeb = {
+    acceptAward,
+    donateTrade,
     encodeShortCode,
+    createCloudVariable,
+    createComment,
     createShortUrl,
+    createSplitRule,
+    decompressShortUrl,
+    deleteComment,
+    foldComment,
     getApprovalTags,
     getCampaignResources,
+    getCcwMainStatus: getCCWMainStatus,
     getCheckInRecords,
+    getCodeProfilingDetail,
     getCommentReplies,
     getCommentsByTopic,
     getConfigDetail,
+    getCreationActivityStatsList,
+    getCreationAttributeDetail,
     getCreationDetail,
+    getCreationFavoriteDetail,
     getCreationIntroduction,
-    getCreationPage,
+    getCreationRecommendPositionList,
+    getCreationReleasePage,
+    getCreationScreenshotPage,
     getCreationStudentDetail,
     getCreationTags,
-    getCreationsByStudent,
+    getCreatorScore,
+    getDonatedRecordRanking,
     getExcellentCreations,
+    getEmojiCategoryList,
+    getEmojiPage,
+    getAllEmojis,
+    getHashTagDetail,
+    getHashTagFavoriteDetail,
+    getHistoricalTeamMemberPage,
+    getManagedHashTags,
+    getHealthCheck: healthCheck,
+    getLeafletsItemList,
     getLikeDetail,
     getLoadingTips,
+    getLockedUserDetail,
+    getMutedUserDetail,
+    getMyHashTagCreations,
+    getMyTasks,
+    getNotifyDeleteReasons,
+    getNotificationPage,
+    getNotificationStats,
+    getOwnCreationPage,
+    getPersonalCurrencyAccount,
+    getPlanetsOfCreation,
+    getPostDetail,
     getPotentialCreations,
     getRecommendCreations,
+    getRecommendHashTags,
+    getRemixedCreationPage,
+    getReputationScoreLogPage: getReputationScoreLog,
+    getSearchHotWords,
+    getSmartContractList,
+    getSplitRuleDetail,
+    getSpreadFeedUnreadCount,
+    getStudentBlockRecordDetail,
+    getStudentBlockRecordList,
+    getStudentBlockStatus,
+    getStudentFollowingPage,
+    getStudentLastActiveAt,
+    getStudentProfile,
+    getStudentSelfDetail,
+    getStudentSessions,
+    getStudentsList,
+    getStudentStats,
+    getStudyCommunityMemberDetail,
+    getSubjectAreaPage,
+    getSubjectAreaPageByChannel,
+    getTeamMemberList,
+    getTeamworkLogPage,
+    getTime,
+    getTypicalProjectPage,
+    getTypicalProjectUnreadCount,
     getUserAssetStorageSize,
+    getUserCardDetail,
+    getUserLabelList,
+    getUserProductsPage,
+    getCreationsByStudent,
     insertCheckInRecord,
+    likeComment,
+    produceTeamMemberTicket,
+    resetCommentWeight,
     searchCloudAssets,
     searchCreationsByTag,
-    getTime,
+    sendEvent,
+    setUserProductStatus,
+    submitCreation,
+    topComment,
+    updateCreation,
+    updateGreatCreation,
+    updateStudent,
+    viewCreationStats,
 };

package/dist/esm/{src/community-web → community-web}/notification/page.js

@@ -1,6 +1,6 @@
 import { ccwAxios } from "@ccw-api/axios";
 import { queryPage, DEFAULT_PAGE_ARGS } from "src/queryPages";
-import { NotificationGroup } from "types/notification";
+import { NotificationGroup } from "src/types/notification";
 export const url = "https://community-web.ccw.site/notification/page";
 /**
  * 分页获取通知列表

package/dist/esm/community-web/smart_contract/list.js

@@ -0,0 +1,14 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/smart_contract/list";
+/**
+ * 列出作品中的智能金币合约
+ * @param {MongoDBId} bizId 业务ID（如作品OID）
+ * @param {SmartContractBizType} bizType 业务类型，CREATION
+ * @returns {Promise<Res>} 智能合约列表
+ */
+export async function getSmartContractList(bizId, bizType = "CREATION") {
+    const req = { bizId, bizType };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/community-web/smart_contract/list.test.js

@@ -0,0 +1,4 @@
+import { getSmartContractList } from "./list";
+test("should fail without token when listing smart contracts", async () => {
+    await expect(getSmartContractList("679d79862de3ec4dde55d534")).rejects.toThrow();
+});

package/dist/esm/community-web/user_package/status.js

@@ -0,0 +1,14 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/user_package/status";
+/**
+ * 设置用户商品状态（如佩戴/卸下头像框）
+ * @param {number} id 用户商品ID
+ * @param {boolean} status 商品状态，true为佩戴，false为卸下
+ * @returns {Promise<Res>} 设置结果
+ */
+export async function setUserProductStatus(id, status) {
+    const req = { status, id };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/community-web/user_package/status.test.js

@@ -0,0 +1,4 @@
+import { setUserProductStatus } from "./status";
+test("should fail without token when setting user product status", async () => {
+    await expect(setUserProductStatus(105847, false)).rejects.toThrow();
+});