@ccw-api/api 0.4.2 → 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/comment/page_by_topic.js

@@ -9,7 +9,7 @@ const dpa = {
  * 根据主题获取评论列表
  * @param {string} subjectOid 主题oid
  * @param {SubjectType} subjectType 主题类型 (如: "POST")
- * @param {string} sectionType 区块类型 (如: "COMMENT")
+ * @param {SectionType} sectionType 区块类型 (如: "COMMENT")
  * @param {Partial<PageArgs<SortField| T>>} pageArgs_ 分页参数
  * @returns {Promise<Res>} 评论分页结果
  */

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

@@ -93,6 +93,10 @@ 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,
@@ -153,6 +157,7 @@ export const communityWeb = {
     getRemixedCreationPage,
     getReputationScoreLogPage: getReputationScoreLog,
     getSearchHotWords,
+    getSmartContractList,
     getSplitRuleDetail,
     getSpreadFeedUnreadCount,
     getStudentBlockRecordDetail,
@@ -176,6 +181,7 @@ export const communityWeb = {
     getUserAssetStorageSize,
     getUserCardDetail,
     getUserLabelList,
+    getUserProductsPage,
     getCreationsByStudent,
     insertCheckInRecord,
     likeComment,
@@ -184,9 +190,11 @@ export const communityWeb = {
     searchCloudAssets,
     searchCreationsByTag,
     sendEvent,
+    setUserProductStatus,
     submitCreation,
     topComment,
     updateCreation,
+    updateGreatCreation,
     updateStudent,
     viewCreationStats,
 };

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();
+});

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

@@ -0,0 +1,29 @@
+import { ccwAxios } from "@ccw-api/axios";
+import { queryPage, DEFAULT_PAGE_ARGS } from "src/queryPages";
+export const url = "https://community-web.ccw.site/user_package/user_product";
+export var ProductCategory;
+(function (ProductCategory) {
+    ProductCategory[ProductCategory["AVATAR_FRAME"] = 5] = "AVATAR_FRAME";
+})(ProductCategory || (ProductCategory = {}));
+/**
+ * 分页获取用户商品（如头像框）
+ * @param {ProductCategory} productCategory 商品分类，默认5为头像框
+ * @param {Partial<PageArgs<SortField>>} pageArgs_ 分页参数
+ * @returns {Promise<Res>} 分页用户商品数据
+ */
+export async function getUserProductsPage(productCategory = ProductCategory.AVATAR_FRAME, pageArgs_ = {}) {
+    const pageArgs = {
+        ...DEFAULT_PAGE_ARGS,
+        ...pageArgs_,
+    };
+    const queryUrl = queryPage(url, pageArgs);
+    const req = {
+        page: pageArgs.page,
+        perPage: pageArgs.perPage,
+        sortType: pageArgs.sortType,
+        productCategory,
+    };
+    return await ccwAxios
+        .post(queryUrl, req)
+        .then((res) => res.data.body);
+}

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

@@ -0,0 +1,9 @@
+import { getUserProductsPage, ProductCategory } from "./user_product";
+test("should fail without token for avatar frame products", async () => {
+    await expect(getUserProductsPage(ProductCategory.AVATAR_FRAME, {
+        page: 1,
+        perPage: 8,
+        sortType: "DESC",
+        sortField: "",
+    })).rejects.toThrow();
+});

package/dist/esm/community-web-cloud-database/cloud_variable/save.js

@@ -0,0 +1,29 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web-cloud-database.ccw.site/cloud_variable/save";
+async function saveCloudVariableBase(primaryKey, secondaryKey, value) {
+    const req = { primaryKey, secondaryKey, value };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}
+/**
+ * 保存作品云变量到云数据库
+ * @param {MongoDBId} projectId 作品id
+ * @param {string} secondaryKey 次级键 - 变量名或标识
+ * @param {T} value 要保存数据
+ * @returns {Promise<SaveCloudVariableRes<T>>} 保存后的值对象
+ */
+export async function saveProjectCloudVariable(projectId, secondaryKey, value) {
+    return await saveCloudVariableBase(projectId, secondaryKey, { v: value });
+}
+/**
+ * 保存数据到用户云数据库
+ * @param {MongoDBId} projectId 作品id
+ * @param {number} studentNum 次级键 - 用户id
+ * @param {T} value 要保存的键值对
+ * @returns {Promise<SaveCloudVariableRes<T>>} 保存后的值对象
+ */
+export async function saveUserCloudVariable(projectId, studentNum, value) {
+    const primaryKey = `${projectId}-u`;
+    return await saveCloudVariableBase(primaryKey, `${studentNum}`, value);
+}

package/dist/esm/community-web-cloud-database/cloud_variable/save.test.js

@@ -0,0 +1,13 @@
+import { saveProjectCloudVariable, saveUserCloudVariable } from "./save";
+test("save project cloud variable should return saved value", async () => {
+    const testValue = "2025-07-05T17:40:53.057+0800";
+    const res = await saveProjectCloudVariable("68dddc63d28b025cb53fae25", "test", testValue);
+    expect(res).toBeDefined();
+    expect(res.v).toBe(testValue);
+});
+test("save user cloud variable should ok", async () => {
+    const res = await saveUserCloudVariable("68dddc63d28b025cb53fae25", 0, {
+        key2: "0",
+    });
+    expect(res.key2).toEqual("0");
+});

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

@@ -0,0 +1,5 @@
+import { saveProjectCloudVariable, saveUserCloudVariable, } from "./cloud_variable/save";
+export const communityWebCloudDatabase = {
+    saveProjectCloudVariable,
+    saveUserCloudVariable,
+};

package/dist/esm/gandi-main/creation/leaderboards/{oid}/records.js

@@ -0,0 +1,28 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://gandi-main.ccw.site/creation/leaderboards";
+/**
+ * 向作品排行榜提交一条分数记录
+ * @param {MongoDBId} leaderboardOid 排行榜id
+ * @param {number} score 分数
+ * @param {MongoDBId} userOid 用户id
+ * @param {string} ext 扩展信息（可选）
+ * @returns {Promise<SubmitRes>} 是否提交成功
+ */
+export async function submitLeaderboardRecord(leaderboardOid, score, userOid, ext = "") {
+    const req = { score, oid: userOid, ext };
+    const requestUrl = `${url}/${leaderboardOid}/records`;
+    return await ccwAxios
+        .post(requestUrl, req)
+        .then((res) => res.data.body);
+}
+/**
+ * 获取作品排行榜记录列表
+ * @param {MongoDBId} leaderboardOid 排行榜id
+ * @returns {Promise<LeaderboardRecordsRes>} 排行榜记录列表
+ */
+export async function getLeaderboardRecords(leaderboardOid) {
+    const requestUrl = `${url}/${leaderboardOid}/records`;
+    return await ccwAxios
+        .get(requestUrl)
+        .then((res) => res.data.body);
+}

package/dist/esm/gandi-main/creation/leaderboards/{oid}/records.test.js

@@ -0,0 +1,11 @@
+import { getLeaderboardRecords, submitLeaderboardRecord } from "./records";
+test("submit leaderboard record should fail without token", async () => {
+    await expect(submitLeaderboardRecord("65a2314daa96bd09b5beae5a", 0, "65a2314daa96bd09b5beae5a", "")).rejects.toThrow();
+});
+test("get leaderboard records should return data", async () => {
+    const res = await getLeaderboardRecords("65a2314daa96bd09b5beae5a");
+    expect(res.oid).toBe("65a2314daa96bd09b5beae5a");
+    expect(res.title).toBeDefined();
+    expect(res.leaderboardRecordTotalNum).toBeDefined();
+    expect(Array.isArray(res.leaderboardRecords)).toBe(true);
+});

package/dist/esm/gandi-main/index.js

@@ -1,8 +1,11 @@
 import { getCurrentTimestamp } from "./timestamp/current";
 import { getBulletinsPage } from "./bulletins/page";
 import { getBulletinDetail } from "./bulletins/detail";
+import { getLeaderboardRecords, submitLeaderboardRecord, } from "./creation/leaderboards/{oid}/records";
 export const gandiMain = {
     getCurrentTimestamp,
     getBulletinsPage,
     getBulletinDetail,
+    submitLeaderboardRecord,
+    getLeaderboardRecords,
 };

package/dist/esm/index.js

@@ -2,11 +2,15 @@ import { sso } from "./sso/index";
 import { communityWeb } from "./community-web";
 import { gandiMain } from "./gandi-main";
 import { bfsWeb } from "./bfs-web";
-export { sso, communityWeb, gandiMain, bfsWeb };
+import { communityWebCloudDatabase } from "./community-web-cloud-database";
+import { opParentApi } from "./op-parent-api";
+export { sso, communityWeb, gandiMain, bfsWeb, communityWebCloudDatabase, opParentApi, };
 export { setToken } from "@ccw-api/axios";
 export default {
     sso,
     communityWeb,
     gandiMain,
     bfsWeb,
+    communityWebCloudDatabase,
+    opParentApi,
 };

package/dist/esm/op-parent-api/captcha/check.js

@@ -0,0 +1,15 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://op-parent-api.xiguacity.cn/captcha/check";
+/**
+ * 校验图形验证码（拼图滑块坐标）
+ * @param {string} token createCaptcha 返回的 token
+ * @param {number} x 拼图滑块目标位置的 x 坐标
+ * @param {number} y 拼图滑块目标位置的 y 坐标
+ * @returns {Promise<Res>} 校验结果
+ */
+export async function checkCaptcha(token, x, y = 5) {
+    const req = { data: { x, y }, token };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/op-parent-api/captcha/check.test.js

@@ -0,0 +1,12 @@
+import { checkCaptcha } from "./check";
+import { createCaptcha } from "./create";
+test("checkCaptcha returns structured result with token and coords without auth", async () => {
+    const created = await createCaptcha("BLOCK_PUZZLE");
+    const res = await checkCaptcha(created.token, 0, -1);
+    expect(res).toHaveProperty("captchaExpired");
+    expect(res).toHaveProperty("errorMsg");
+    expect(res).toHaveProperty("success");
+    expect(res.captchaExpired).toBeFalsy();
+    expect(res.success).toBeFalsy();
+    expect(res.errorMsg).toEqual("验证失败");
+}, 30000);

package/dist/esm/op-parent-api/captcha/create.js

@@ -0,0 +1,13 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://op-parent-api.xiguacity.cn/captcha/create";
+/**
+ * 创建图形验证码（拼图滑块）
+ * @param {CaptchaType} type 验证码类型,默认 BLOCK_PUZZLE（滑块拼图）
+ * @returns {Promise<Res>} 验证码信息:bgImg为背景图base64 data url,jigsawImg为拼图块base64 data url,token用于后续校验
+ */
+export async function createCaptcha(type = "BLOCK_PUZZLE") {
+    const req = { type };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/op-parent-api/captcha/create.test.js

@@ -0,0 +1,13 @@
+import { createCaptcha } from "./create";
+test("create BLOCK_PUZZLE captcha returns bgImg, jigsawImg and token without token", async () => {
+    const res = await createCaptcha("BLOCK_PUZZLE");
+    expect(res).toHaveProperty("data");
+    expect(res.data).toHaveProperty("bgImg");
+    expect(res.data).toHaveProperty("jigsawImg");
+    expect(res).toHaveProperty("token");
+    expect(typeof res.token).toBe("string");
+    expect(typeof res.data.bgImg).toBe("string");
+    expect(typeof res.data.jigsawImg).toBe("string");
+    expect(res.data.bgImg.startsWith("data:image/png;base64,")).toBeTruthy();
+    expect(res.data.jigsawImg.startsWith("data:image/png;base64,")).toBeTruthy();
+}, 30000);

package/dist/esm/op-parent-api/index.js

@@ -0,0 +1,6 @@
+import { createCaptcha } from "./captcha/create";
+import { checkCaptcha } from "./captcha/check";
+export const opParentApi = {
+    createCaptcha,
+    checkCaptcha,
+};

package/dist/esm/sso/index.js

@@ -1,8 +1,12 @@
 import { loginByPassword } from "./web/auth/login-by-password";
 import { logout } from "./web/auth/logout";
 import { logoutBySession } from "./web/auth/logout_by_session";
+import { createSmsCaptcha } from "./web/auth/assistant/captcha/v2/create";
+import { loginByPhone } from "./web/auth/v3/login/by-phone";
 export const sso = {
     loginByPassword,
     logout,
     logoutBySession,
+    createSmsCaptcha,
+    loginByPhone,
 };

package/dist/esm/sso/web/auth/assistant/captcha/v2/create.js

@@ -0,0 +1,17 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://sso.ccw.site/web/auth/assistant/captcha/v2/create";
+/**
+ * 发送短信验证码
+ * @param {string} recipient 接收手机号，如 "10011451919"
+ * @param {SmsScene} scene 场景，默认 loginbyPhone
+ * @param {string} countryCode 国家代码，默认 "86"
+ * @param {SmsRuleCode} ruleCode 短信规则编码，默认 "ccw_sms"
+ * @param {CaptchaPayload} captcha 图形验证码校验结果（滑块拼图的坐标与token），可选（部分场景未强制要求时可省略，但失败时sendResult!=1）
+ * @returns {Promise<Res>} 发送结果：batchId 为短信批次ID，sendResult=1 表示成功
+ */
+export async function createSmsCaptcha(recipient, scene = "loginbyPhone", countryCode = "86", ruleCode = "ccw_sms", captcha) {
+    const req = { recipient, countryCode, scene, ruleCode, captcha };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/sso/web/auth/assistant/captcha/v2/create.test.js

@@ -0,0 +1,8 @@
+import { createSmsCaptcha } from "./create";
+test("createSmsCaptchaV2 returns batchId and sendResult fields without token", async () => {
+    const res = await createSmsCaptcha("12345671145", "loginbyPhone", "86", "ccw_sms");
+    expect(res).toHaveProperty("batchId");
+    expect(res).toHaveProperty("sendResult");
+    expect(res.batchId).toBeNull();
+    expect(res.sendResult).toBe(2);
+}, 30000);

package/dist/esm/sso/web/auth/login-by-password.js

@@ -11,13 +11,14 @@ export async function loginByPassword(loginKey, password, reqExtra = {
     device: "Node",
     browser: "Node.js",
 }) {
-    const { extra, ...restBody } = await ccwAxios
-        .post(url, {
+    const req = {
         loginKey,
         password,
         clientCode: "STUDY_COMMUNITY",
         extra: JSON.stringify({ ...reqExtra, scene: null }),
-    })
+    };
+    const { extra, ...restBody } = await ccwAxios
+        .post(url, req)
         .then((res) => res.data.body);
     const resExtra = JSON.parse(extra);
     return {

package/dist/esm/sso/web/auth/v3/login/by-phone.js

@@ -0,0 +1,33 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://sso.ccw.site/web/auth/v3/login/by_phone";
+/**
+ * 通过手机号+短信验证码登录（V3）
+ * @param {string} phone 手机号，如 "12345671145"
+ * @param {string} code 收到的短信验证码
+ * @param {ReqExtra} reqExtra 设备和浏览器信息
+ * @param {string} countryCode 国家代码，默认 "86"
+ * @param {LoginRuleCode} ruleCode 短信规则编码，默认 "ccw_sms"
+ * @param {LoginScene} scene 登录场景，默认 "loginbyPhone"
+ * @returns {Promise<Res<Extra>>} session 信息
+ */
+export async function loginByPhone(phone, code, reqExtra = {
+    device: "Node",
+    browser: "Node.js",
+}, countryCode = "86", ruleCode = "ccw_sms", scene = "loginbyPhone") {
+    const { extra, ...restBody } = await ccwAxios
+        .post(url, {
+        phone,
+        code,
+        countryCode,
+        ruleCode,
+        scene,
+        clientCode: "STUDY_COMMUNITY",
+        extra: JSON.stringify({ ...reqExtra, scene: null }),
+    })
+        .then((res) => res.data.body);
+    const resExtra = JSON.parse(extra);
+    return {
+        ...restBody,
+        extra: resExtra,
+    };
+}

package/dist/esm/sso/web/auth/v3/login/by-phone.test.js

@@ -0,0 +1,7 @@
+import { loginByPhone } from "./by-phone";
+test("expect wrong sms code to throw error", async () => {
+    await expect(loginByPhone("12345671145", "000000", {
+        device: "Node.js Test",
+        browser: "Jest",
+    })).rejects.toThrow();
+}, 30000);

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

@@ -13,7 +13,7 @@ const dpa = {
  * 根据主题获取评论列表
  * @param {string} subjectOid 主题oid
  * @param {SubjectType} subjectType 主题类型 (如: "POST")
- * @param {string} sectionType 区块类型 (如: "COMMENT")
+ * @param {SectionType} sectionType 区块类型 (如: "COMMENT")
  * @param {Partial<PageArgs<SortField| T>>} pageArgs_ 分页参数
  * @returns {Promise<Res>} 评论分页结果
  */

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

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

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

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const update_1 = require("./update");
+test("should fail without token when updating great creation", async () => {
+    await expect((0, update_1.updateGreatCreation)("69740f1a61b891733d5ee2c6")).rejects.toThrow();
+});