@ccw-api/api 0.4.2 → 0.6.0

package/dist/esm/community-web/ccw-mall/ccw/product/fe/query.js

@@ -0,0 +1,34 @@
+import { ccwAxios } from "@ccw-api/axios";
+import { DEFAULT_PAGE_ARGS, queryPage } from "src/queryPages";
+export const url = "https://community-web.ccw.site/ccw-mall/ccw/product/fe/query";
+export var ProductCategory;
+(function (ProductCategory) {
+    ProductCategory[ProductCategory["Merchandise"] = 7] = "Merchandise";
+    ProductCategory[ProductCategory["AvatarFrame"] = 5] = "AvatarFrame";
+    ProductCategory[ProductCategory["EMOJI"] = 10] = "EMOJI";
+})(ProductCategory || (ProductCategory = {}));
+/**
+ * 分页查询CCW小商店商品列表
+ * @param {ProductCategory | undefined} productCategory 商品分类（可选）：5=头像框，7=周边商品，10=表情 等
+ * @param {Partial<PageArgs<ProductSortField>>} pageArgs_ 分页参数（默认 page=1, perPage=30, sortType="DESC"）
+ * @returns {Promise<Res>} 商品分页结果 PagesRes<Product>
+ */
+export async function queryMallProducts(productCategory, pageArgs_ = {
+    sortField: "createdAt",
+}) {
+    const pageArgs = {
+        ...DEFAULT_PAGE_ARGS,
+        ...pageArgs_,
+    };
+    const queryUrl = queryPage(url, pageArgs);
+    const req = {
+        page: pageArgs.page,
+        perPage: pageArgs.perPage,
+        sortType: pageArgs.sortType,
+        productCategory,
+        source: "CCW_OFFICIAL",
+    };
+    return await ccwAxios
+        .post(queryUrl, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/community-web/ccw-mall/ccw/product/fe/query.test.js

@@ -0,0 +1,8 @@
+import { queryMallProducts } from "./query";
+test("query mall product page should fail without token", async () => {
+    await expect(queryMallProducts(7, {
+        page: 1,
+        perPage: 30,
+        sortType: "DESC",
+    })).rejects.toThrow();
+});

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/extensions/creation-like/detail.js

@@ -0,0 +1,14 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/extensions/creation-like/detail";
+/**
+ * [连接社区扩展] 查询用户对作品的点赞交互状态
+ * @param {MongoDBId} playingCreationOid 当前播放的作品 OID
+ * @param {MongoDBId} creationOid 目标作品 OID
+ * @returns {Promise<Res>} 点赞状态及作品信息
+ */
+export async function getConnectCommunityCreationLikeStatus(playingCreationOid, creationOid) {
+    const req = { playingCreationOid, creationOid };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

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

@@ -0,0 +1,4 @@
+import { getConnectCommunityCreationLikeStatus } from "./detail";
+test("should fail without token when getting creation like status", async () => {
+    await expect(getConnectCommunityCreationLikeStatus("6a3fa1ed159ed52f170c34d2", "6a3fa1ed159ed52f170c34d2")).rejects.toThrow();
+});

package/dist/esm/community-web/extensions/following/status.js

@@ -0,0 +1,14 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/extensions/following/status";
+/**
+ * [连接社区扩展] 查询是否关注了指定创作者
+ * @param {MongoDBId} playingCreationOid 当前播放的作品 OID
+ * @param {MongoDBId} userOid 目标用户 OID
+ * @returns {Promise<Res>} 关注状态及用户信息
+ */
+export async function getConnectCommunityFollowingStatus(playingCreationOid, userOid) {
+    const req = { playingCreationOid, userOid };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/community-web/extensions/following/status.test.js

@@ -0,0 +1,4 @@
+import { getConnectCommunityFollowingStatus } from "./status";
+test("should fail without token when getting following status", async () => {
+    await expect(getConnectCommunityFollowingStatus("6a3fa1ed159ed52f170c34d2", "651e3f7310b0530e7f80fe7a")).rejects.toThrow();
+});

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

@@ -9,6 +9,7 @@ import { searchCloudAssets } from "./cloud_asset/search";
 import { getCommentReplies } from "./comment/page";
 import { getCommentsByTopic } from "./comment/page_by_topic";
 import { getConfigDetail } from "./config/detail";
+import { queryMallProducts } from "./ccw-mall/ccw/product/fe/query";
 import { getCreationDetail } from "./creation/detail";
 import { getExcellentCreations } from "./creation/excellent/list";
 import { getCreationIntroduction } from "./creation/introduction/detail";
@@ -93,10 +94,21 @@ 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 { executeSmartContract } from "./smart_contract/execute";
+import { getSmartContractAccount } from "./smart_contract/account";
+import { getSmartContractDetail } from "./smart_contract/detail";
+import { getSmartContractList } from "./smart_contract/list";
+import { getConnectCommunityFollowingStatus } from "./extensions/following/status";
+import { getConnectCommunityCreationLikeStatus } from "./extensions/creation-like/detail";
+import { followCreator } from "./study-community/following/follow";
 export const communityWeb = {
     acceptAward,
     donateTrade,
     encodeShortCode,
+    executeSmartContract,
     createCloudVariable,
     createComment,
     createShortUrl,
@@ -104,6 +116,7 @@ export const communityWeb = {
     decompressShortUrl,
     deleteComment,
     foldComment,
+    followCreator,
     getApprovalTags,
     getCampaignResources,
     getCcwMainStatus: getCCWMainStatus,
@@ -117,6 +130,7 @@ export const communityWeb = {
     getCreationDetail,
     getCreationFavoriteDetail,
     getCreationIntroduction,
+    getConnectCommunityCreationLikeStatus,
     getCreationRecommendPositionList,
     getCreationReleasePage,
     getCreationScreenshotPage,
@@ -125,6 +139,7 @@ export const communityWeb = {
     getCreatorScore,
     getDonatedRecordRanking,
     getExcellentCreations,
+    getConnectCommunityFollowingStatus,
     getEmojiCategoryList,
     getEmojiPage,
     getAllEmojis,
@@ -153,6 +168,9 @@ export const communityWeb = {
     getRemixedCreationPage,
     getReputationScoreLogPage: getReputationScoreLog,
     getSearchHotWords,
+    getSmartContractAccount,
+    getSmartContractDetail,
+    getSmartContractList,
     getSplitRuleDetail,
     getSpreadFeedUnreadCount,
     getStudentBlockRecordDetail,
@@ -176,6 +194,8 @@ export const communityWeb = {
     getUserAssetStorageSize,
     getUserCardDetail,
     getUserLabelList,
+    getUserProductsPage,
+    queryMallProducts,
     getCreationsByStudent,
     insertCheckInRecord,
     likeComment,
@@ -184,9 +204,11 @@ export const communityWeb = {
     searchCloudAssets,
     searchCreationsByTag,
     sendEvent,
+    setUserProductStatus,
     submitCreation,
     topComment,
     updateCreation,
+    updateGreatCreation,
     updateStudent,
     viewCreationStats,
 };

package/dist/esm/community-web/post/post.test.js

@@ -1,7 +1,6 @@
 import { getPostDetail } from "./detail";
 test("get post detail", async () => {
     const detail = await getPostDetail("0173b23d-139d-4c48-ad98-0aa17b5d3b60");
-    console.log(detail);
     await expect(detail.title.includes("【公告通知】")).toBeTruthy();
 });
 test("error when post detail not found", async () => {

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

@@ -0,0 +1,13 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/smart_contract/account";
+/**
+ * 查询智能合约账户余额
+ * @param {number} id 合约 ID
+ * @returns {Promise<Res>} 合约账户余额
+ */
+export async function getSmartContractAccount(id) {
+    const req = { id };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

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

@@ -0,0 +1,4 @@
+import { getSmartContractAccount } from "./account";
+test("should fail without token when getting smart contract account", async () => {
+    await expect(getSmartContractAccount(2022277721908162)).rejects.toThrow();
+});

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

@@ -0,0 +1,13 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/smart_contract/detail";
+/**
+ * 获取智能合约详情
+ * @param {number} id 合约 ID
+ * @returns {Promise<Res>} 合约详情
+ */
+export async function getSmartContractDetail(id) {
+    const req = { id };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

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

@@ -0,0 +1,4 @@
+import { getSmartContractDetail } from "./detail";
+test("should fail without token when getting smart contract detail", async () => {
+    await expect(getSmartContractDetail(2022277721908162)).rejects.toThrow();
+});

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

@@ -0,0 +1,17 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/smart_contract/execute";
+/**
+ * 执行智能合约（投币/领取奖励）
+ * @param {MongoDBId} bizId 业务 ID（如作品 OID）
+ * @param {SmartContractBizType} bizType 业务类型，CREATION
+ * @param {number} id 合约 ID
+ * @param {number} ruleId 规则 ID
+ * @param {number} bucks 金币数量
+ * @returns {Promise<Res>} 执行结果
+ */
+export async function executeSmartContract(bizId, id, ruleId, bucks, bizType = "CREATION") {
+    const req = { bizId, bizType, id, ruleId, params: { bucks } };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

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

@@ -0,0 +1,4 @@
+import { executeSmartContract } from "./execute";
+test("should fail without token when executing smart contract", async () => {
+    await expect(executeSmartContract("6a3fa1ed159ed52f170c34d2", 2022277721908162, 378074, 1)).rejects.toThrow();
+});

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/study-community/following/follow.js

@@ -0,0 +1,13 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web.ccw.site/study-community/following/follow";
+/**
+ * 关注创作者
+ * @param {MongoDBId} followingOid 要关注的用户 OID
+ * @returns {Promise<Res>} "FOLLOWED" 表示关注成功
+ */
+export async function followCreator(followingOid) {
+    const req = { followingOid };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

package/dist/esm/community-web/study-community/following/follow.test.js

@@ -0,0 +1,4 @@
+import { followCreator } from "./follow";
+test("should fail without token when following creator", async () => {
+    await expect(followCreator("651e3f7310b0530e7f80fe7a")).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/detail/v2.js

@@ -0,0 +1,16 @@
+import { ccwAxios } from "@ccw-api/axios";
+export const url = "https://community-web-cloud-database.ccw.site/cloud_variable/detail/v2";
+/**
+ * 查询云变量详情 V2
+ * @param {string} accessKey 访问密钥（如作品 OID）
+ * @param {string} primaryKey 主键（如 `${projectId}-u`）
+ * @param {string} secondaryKey 次级键
+ * @param {string[]} filterKeys 过滤的变量名列表
+ * @returns {Promise<Res>} 云变量详情
+ */
+export async function getCloudVariableDetailV2(accessKey, primaryKey, secondaryKey, filterKeys) {
+    const req = { accessKey, primaryKey, secondaryKey, filterKeys };
+    return await ccwAxios
+        .post(url, req)
+        .then((res) => res.data.body);
+}

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

@@ -0,0 +1,4 @@
+import { getCloudVariableDetailV2 } from "./v2";
+test("get cloud variable detail v2 should reject with invalid params", async () => {
+    await expect(getCloudVariableDetailV2("6a3fa1ed159ed52f170c34d2", "6a3fa1ed159ed52f170c34d2-u", "244373873", ["4576y!!2"])).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,7 @@
+import { saveProjectCloudVariable, saveUserCloudVariable, } from "./cloud_variable/save";
+import { getCloudVariableDetailV2 } from "./cloud_variable/detail/v2";
+export const communityWebCloudDatabase = {
+    saveProjectCloudVariable,
+    saveUserCloudVariable,
+    getCloudVariableDetailV2,
+};

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