@ccw-api/api 0.4.2 → 0.6.0

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

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const records_1 = require("./records");
+test("submit leaderboard record should fail without token", async () => {
+    await expect((0, records_1.submitLeaderboardRecord)("65a2314daa96bd09b5beae5a", 0, "65a2314daa96bd09b5beae5a", "")).rejects.toThrow();
+});
+test("get leaderboard records should return data", async () => {
+    const res = await (0, records_1.getLeaderboardRecords)("65a2314daa96bd09b5beae5a");
+    expect(res.oid).toBe("65a2314daa96bd09b5beae5a");
+    expect(res.title).toBeDefined();
+    expect(res.leaderboardRecordTotalNum).toBeDefined();
+    expect(Array.isArray(res.leaderboardRecords)).toBe(true);
+});

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

@@ -4,8 +4,11 @@ exports.gandiMain = void 0;
 const current_1 = require("./timestamp/current");
 const page_1 = require("./bulletins/page");
 const detail_1 = require("./bulletins/detail");
+const records_1 = require("./creation/leaderboards/{oid}/records");
 exports.gandiMain = {
     getCurrentTimestamp: current_1.getCurrentTimestamp,
     getBulletinsPage: page_1.getBulletinsPage,
     getBulletinDetail: detail_1.getBulletinDetail,
+    submitLeaderboardRecord: records_1.submitLeaderboardRecord,
+    getLeaderboardRecords: records_1.getLeaderboardRecords,
 };

package/dist/node/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setToken = exports.bfsWeb = exports.gandiMain = exports.communityWeb = exports.sso = void 0;
+exports.setToken = exports.opParentApi = exports.communityWebCloudDatabase = exports.bfsWeb = exports.gandiMain = exports.communityWeb = exports.sso = void 0;
 const index_1 = require("./sso/index");
 Object.defineProperty(exports, "sso", { enumerable: true, get: function () { return index_1.sso; } });
 const community_web_1 = require("./community-web");
@@ -9,6 +9,10 @@ const gandi_main_1 = require("./gandi-main");
 Object.defineProperty(exports, "gandiMain", { enumerable: true, get: function () { return gandi_main_1.gandiMain; } });
 const bfs_web_1 = require("./bfs-web");
 Object.defineProperty(exports, "bfsWeb", { enumerable: true, get: function () { return bfs_web_1.bfsWeb; } });
+const community_web_cloud_database_1 = require("./community-web-cloud-database");
+Object.defineProperty(exports, "communityWebCloudDatabase", { enumerable: true, get: function () { return community_web_cloud_database_1.communityWebCloudDatabase; } });
+const op_parent_api_1 = require("./op-parent-api");
+Object.defineProperty(exports, "opParentApi", { enumerable: true, get: function () { return op_parent_api_1.opParentApi; } });
 var axios_1 = require("@ccw-api/axios");
 Object.defineProperty(exports, "setToken", { enumerable: true, get: function () { return axios_1.setToken; } });
 exports.default = {
@@ -16,4 +20,6 @@ exports.default = {
     communityWeb: community_web_1.communityWeb,
     gandiMain: gandi_main_1.gandiMain,
     bfsWeb: bfs_web_1.bfsWeb,
+    communityWebCloudDatabase: community_web_cloud_database_1.communityWebCloudDatabase,
+    opParentApi: op_parent_api_1.opParentApi,
 };

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

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.url = void 0;
+exports.checkCaptcha = checkCaptcha;
+const axios_1 = require("@ccw-api/axios");
+exports.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>} 校验结果
+ */
+async function checkCaptcha(token, x, y = 5) {
+    const req = { data: { x, y }, token };
+    return await axios_1.ccwAxios
+        .post(exports.url, req)
+        .then((res) => res.data.body);
+}

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const check_1 = require("./check");
+const create_1 = require("./create");
+test("checkCaptcha returns structured result with token and coords without auth", async () => {
+    const created = await (0, create_1.createCaptcha)("BLOCK_PUZZLE");
+    const res = await (0, check_1.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/node/op-parent-api/captcha/create.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.url = void 0;
+exports.createCaptcha = createCaptcha;
+const axios_1 = require("@ccw-api/axios");
+exports.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用于后续校验
+ */
+async function createCaptcha(type = "BLOCK_PUZZLE") {
+    const req = { type };
+    return await axios_1.ccwAxios
+        .post(exports.url, req)
+        .then((res) => res.data.body);
+}

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

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const create_1 = require("./create");
+test("create BLOCK_PUZZLE captcha returns bgImg, jigsawImg and token without token", async () => {
+    const res = await (0, create_1.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/node/op-parent-api/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.opParentApi = void 0;
+const create_1 = require("./captcha/create");
+const check_1 = require("./captcha/check");
+exports.opParentApi = {
+    createCaptcha: create_1.createCaptcha,
+    checkCaptcha: check_1.checkCaptcha,
+};

package/dist/node/sso/index.js

@@ -4,8 +4,12 @@ exports.sso = void 0;
 const login_by_password_1 = require("./web/auth/login-by-password");
 const logout_1 = require("./web/auth/logout");
 const logout_by_session_1 = require("./web/auth/logout_by_session");
+const create_1 = require("./web/auth/assistant/captcha/v2/create");
+const by_phone_1 = require("./web/auth/v3/login/by-phone");
 exports.sso = {
     loginByPassword: login_by_password_1.loginByPassword,
     logout: logout_1.logout,
     logoutBySession: logout_by_session_1.logoutBySession,
+    createSmsCaptcha: create_1.createSmsCaptcha,
+    loginByPhone: by_phone_1.loginByPhone,
 };

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.url = void 0;
+exports.createSmsCaptcha = createSmsCaptcha;
+const axios_1 = require("@ccw-api/axios");
+exports.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 表示成功
+ */
+async function createSmsCaptcha(recipient, scene = "loginbyPhone", countryCode = "86", ruleCode = "ccw_sms", captcha) {
+    const req = { recipient, countryCode, scene, ruleCode, captcha };
+    return await axios_1.ccwAxios
+        .post(exports.url, req)
+        .then((res) => res.data.body);
+}

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const create_1 = require("./create");
+test("createSmsCaptchaV2 returns batchId and sendResult fields without token", async () => {
+    const res = await (0, create_1.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/node/sso/web/auth/login-by-password.js

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

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

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.url = void 0;
+exports.loginByPhone = loginByPhone;
+const axios_1 = require("@ccw-api/axios");
+exports.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 信息
+ */
+async function loginByPhone(phone, code, reqExtra = {
+    device: "Node",
+    browser: "Node.js",
+}, countryCode = "86", ruleCode = "ccw_sms", scene = "loginbyPhone") {
+    const { extra, ...restBody } = await axios_1.ccwAxios
+        .post(exports.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/node/sso/web/auth/v3/login/by-phone.test.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const by_phone_1 = require("./by-phone");
+test("expect wrong sms code to throw error", async () => {
+    await expect((0, by_phone_1.loginByPhone)("12345671145", "000000", {
+        device: "Node.js Test",
+        browser: "Jest",
+    })).rejects.toThrow();
+}, 30000);

package/dist/types/community-web/ccw-mall/ccw/product/fe/query.d.ts

@@ -0,0 +1,54 @@
+import { CNameOssUrl, MongoDBId } from "src/types/api";
+import { PagesRes, PageArgs, SortType } from "src/types/pages";
+export declare const url = "https://community-web.ccw.site/ccw-mall/ccw/product/fe/query";
+export declare enum ProductCategory {
+    Merchandise = 7,
+    AvatarFrame = 5,
+    EMOJI = 10
+}
+export type ProductSource = "CCW_OFFICIAL";
+export type ProductType = 1 | 2 | 3;
+export type ProductSortField = "createdAt" | "updatedAt" | "pointPrice" | "priority" | "stockNum";
+export type Product = {
+    createdAt: number;
+    description: string;
+    elements: unknown[];
+    functionDescribe: string;
+    id: number;
+    name: string;
+    note: string;
+    offlineAt: null | number;
+    oid: MongoDBId;
+    onlineAt: number;
+    originPointPrice: number;
+    originPrice: number;
+    periodValidityDay: null | number;
+    periodValidityTime: null | number;
+    picUrl: null | CNameOssUrl | string;
+    pointPrice: number;
+    price: number;
+    priority: number;
+    productCategory: ProductCategory;
+    purchaseLimitationNum: number;
+    source: ProductSource;
+    status: number;
+    stockNum: number;
+    type: ProductType;
+    updatedAt: number;
+    virtualValue: null | CNameOssUrl | string;
+};
+export type Req = {
+    page: number;
+    perPage: number;
+    productCategory?: ProductCategory;
+    sortType: SortType;
+    source?: ProductSource;
+};
+export type Res = PagesRes<Product, ProductSortField>;
+/**
+ * 分页查询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 declare function queryMallProducts<T extends string>(productCategory?: ProductCategory, pageArgs_?: Partial<PageArgs<ProductSortField | T>>): Promise<Res>;

package/dist/types/community-web/comment/page_by_topic.d.ts

@@ -12,7 +12,7 @@ export type Res = PagesRes<Comment>;
  * 根据主题获取评论列表
  * @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/types/community-web/extensions/creation-like/detail.d.ts

@@ -0,0 +1,18 @@
+import { MongoDBId } from "src/types/api";
+export declare const url = "https://community-web.ccw.site/extensions/creation-like/detail";
+export type Req = {
+    playingCreationOid: MongoDBId;
+    creationOid: MongoDBId;
+};
+export type Res = {
+    interactionStatus: boolean;
+    oid: MongoDBId;
+    title: string;
+};
+/**
+ * [连接社区扩展] 查询用户对作品的点赞交互状态
+ * @param {MongoDBId} playingCreationOid 当前播放的作品 OID
+ * @param {MongoDBId} creationOid 目标作品 OID
+ * @returns {Promise<Res>} 点赞状态及作品信息
+ */
+export declare function getConnectCommunityCreationLikeStatus(playingCreationOid: MongoDBId, creationOid: MongoDBId): Promise<Res>;

package/dist/types/community-web/extensions/following/status.d.ts

@@ -0,0 +1,19 @@
+import { MongoDBId, CNameOssUrl } from "src/types/api";
+export declare const url = "https://community-web.ccw.site/extensions/following/status";
+export type Req = {
+    playingCreationOid: MongoDBId;
+    userOid: MongoDBId;
+};
+export type Res = {
+    avatar: CNameOssUrl;
+    isFollowing: boolean;
+    name: string;
+    oid: MongoDBId;
+};
+/**
+ * [连接社区扩展] 查询是否关注了指定创作者
+ * @param {MongoDBId} playingCreationOid 当前播放的作品 OID
+ * @param {MongoDBId} userOid 目标用户 OID
+ * @returns {Promise<Res>} 关注状态及用户信息
+ */
+export declare function getConnectCommunityFollowingStatus(playingCreationOid: MongoDBId, userOid: MongoDBId): Promise<Res>;

package/dist/types/community-web/great_creation/update.d.ts

@@ -0,0 +1,12 @@
+import { MongoDBId } from "src/types/api";
+export declare const url = "https://community-web.ccw.site/great_creation/update";
+export type Req = {
+    creationOid: MongoDBId | "";
+};
+export type Res = boolean;
+/**
+ * 更换代表作
+ * @param {MongoDBId|""} creationOid 作品OID 若为""则是取消展示
+ * @returns {Promise<Res>} 更换结果
+ */
+export declare function updateGreatCreation(creationOid: MongoDBId | ""): Promise<Res>;

package/dist/types/community-web/index.d.ts

@@ -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 declare const communityWeb: {
     acceptAward: typeof acceptAward;
     donateTrade: typeof donateTrade;
     encodeShortCode: typeof encodeShortCode;
+    executeSmartContract: typeof executeSmartContract;
     createCloudVariable: typeof createCloudVariable;
     createComment: typeof createComment;
     createShortUrl: typeof createShortUrl;
@@ -104,6 +116,7 @@ export declare const communityWeb: {
     decompressShortUrl: typeof decompressShortUrl;
     deleteComment: typeof deleteComment;
     foldComment: typeof foldComment;
+    followCreator: typeof followCreator;
     getApprovalTags: typeof getApprovalTags;
     getCampaignResources: typeof getCampaignResources;
     getCcwMainStatus: typeof getCCWMainStatus;
@@ -117,6 +130,7 @@ export declare const communityWeb: {
     getCreationDetail: typeof getCreationDetail;
     getCreationFavoriteDetail: typeof getCreationFavoriteDetail;
     getCreationIntroduction: typeof getCreationIntroduction;
+    getConnectCommunityCreationLikeStatus: typeof getConnectCommunityCreationLikeStatus;
     getCreationRecommendPositionList: typeof getCreationRecommendPositionList;
     getCreationReleasePage: typeof getCreationReleasePage;
     getCreationScreenshotPage: typeof getCreationScreenshotPage;
@@ -125,6 +139,7 @@ export declare const communityWeb: {
     getCreatorScore: typeof getCreatorScore;
     getDonatedRecordRanking: typeof getDonatedRecordRanking;
     getExcellentCreations: typeof getExcellentCreations;
+    getConnectCommunityFollowingStatus: typeof getConnectCommunityFollowingStatus;
     getEmojiCategoryList: typeof getEmojiCategoryList;
     getEmojiPage: typeof getEmojiPage;
     getAllEmojis: typeof getAllEmojis;
@@ -153,6 +168,9 @@ export declare const communityWeb: {
     getRemixedCreationPage: typeof getRemixedCreationPage;
     getReputationScoreLogPage: typeof getReputationScoreLog;
     getSearchHotWords: typeof getSearchHotWords;
+    getSmartContractAccount: typeof getSmartContractAccount;
+    getSmartContractDetail: typeof getSmartContractDetail;
+    getSmartContractList: typeof getSmartContractList;
     getSplitRuleDetail: typeof getSplitRuleDetail;
     getSpreadFeedUnreadCount: typeof getSpreadFeedUnreadCount;
     getStudentBlockRecordDetail: typeof getStudentBlockRecordDetail;
@@ -176,6 +194,8 @@ export declare const communityWeb: {
     getUserAssetStorageSize: typeof getUserAssetStorageSize;
     getUserCardDetail: typeof getUserCardDetail;
     getUserLabelList: typeof getUserLabelList;
+    getUserProductsPage: typeof getUserProductsPage;
+    queryMallProducts: typeof queryMallProducts;
     getCreationsByStudent: typeof getCreationsByStudent;
     insertCheckInRecord: typeof insertCheckInRecord;
     likeComment: typeof likeComment;
@@ -184,9 +204,11 @@ export declare const communityWeb: {
     searchCloudAssets: typeof searchCloudAssets;
     searchCreationsByTag: typeof searchCreationsByTag;
     sendEvent: typeof sendEvent;
+    setUserProductStatus: typeof setUserProductStatus;
     submitCreation: typeof submitCreation;
     topComment: typeof topComment;
     updateCreation: typeof updateCreation;
+    updateGreatCreation: typeof updateGreatCreation;
     updateStudent: typeof updateStudent;
     viewCreationStats: typeof viewCreationStats;
 };

package/dist/types/community-web/post/detail.d.ts

@@ -31,7 +31,7 @@ export type Res = {
     oid: MongoDBId;
     pageView: number;
     publishedAt: number;
-    rank: string;
+    rank: "EXCELLENT" | "ORDINARY";
     rankUpdatedAt: null | number;
     reviewedAt: number;
     slug: string;

package/dist/types/community-web/smart_contract/account.d.ts

@@ -0,0 +1,13 @@
+export declare const url = "https://community-web.ccw.site/smart_contract/account";
+export type Req = {
+    id: number;
+};
+export type Res = {
+    balance: number;
+};
+/**
+ * 查询智能合约账户余额
+ * @param {number} id 合约 ID
+ * @returns {Promise<Res>} 合约账户余额
+ */
+export declare function getSmartContractAccount(id: number): Promise<Res>;

package/dist/types/community-web/smart_contract/detail.d.ts

@@ -0,0 +1,24 @@
+import { MongoDBId } from "src/types/api";
+import { SmartContractBizType, SmartContractRule } from "./list";
+export declare const url = "https://community-web.ccw.site/smart_contract/detail";
+export type Req = {
+    id: number;
+};
+export type Res = {
+    accountId: MongoDBId;
+    bizId: MongoDBId;
+    bizType: SmartContractBizType;
+    createdAt: number;
+    id: number;
+    rules: SmartContractRule[];
+    status: "ENABLED";
+    title: string;
+    type: string;
+    updatedAt: number;
+};
+/**
+ * 获取智能合约详情
+ * @param {number} id 合约 ID
+ * @returns {Promise<Res>} 合约详情
+ */
+export declare function getSmartContractDetail(id: number): Promise<Res>;

package/dist/types/community-web/smart_contract/execute.d.ts

@@ -0,0 +1,25 @@
+import { MongoDBId } from "src/types/api";
+import { SmartContractBizType } from "./list";
+export declare const url = "https://community-web.ccw.site/smart_contract/execute";
+export type Req = {
+    bizId: MongoDBId;
+    bizType: SmartContractBizType;
+    id: number;
+    ruleId: number;
+    params: {
+        bucks: number;
+    };
+};
+export type Res = {
+    success: boolean;
+};
+/**
+ * 执行智能合约（投币/领取奖励）
+ * @param {MongoDBId} bizId 业务 ID（如作品 OID）
+ * @param {SmartContractBizType} bizType 业务类型，CREATION
+ * @param {number} id 合约 ID
+ * @param {number} ruleId 规则 ID
+ * @param {number} bucks 金币数量
+ * @returns {Promise<Res>} 执行结果
+ */
+export declare function executeSmartContract(bizId: MongoDBId, id: number, ruleId: number, bucks: number, bizType?: SmartContractBizType): Promise<Res>;

package/dist/types/community-web/smart_contract/list.d.ts

@@ -0,0 +1,49 @@
+import { MongoDBId } from "src/types/api";
+export declare const url = "https://community-web.ccw.site/smart_contract/list";
+export type SmartContractBizType = "CREATION";
+export type Req = {
+    bizId: MongoDBId;
+    bizType: SmartContractBizType;
+};
+export type SmartContractRule = {
+    createdAt: number;
+    id: number;
+    rule: {
+        awardeeAccountId?: "${curUserAccountId}";
+        awarderAccountId?: "${smartContractAccountId}";
+        bucks: "${bucks}";
+        code: "donate" | "award";
+        donatorAccountId?: "${curUserAccountId}";
+        funSignature: {
+            en: string;
+            zh_cn: string;
+        };
+        splitDetailList?: {
+            accountId: "${smartContractAccountId}" | "${creationAccountId}";
+            rate: number;
+        }[];
+        title: string;
+    };
+    smartContractId: number;
+    updatedAt: number;
+};
+export type SmartCoinContract = {
+    accountId: MongoDBId;
+    bizId: MongoDBId;
+    bizType: SmartContractBizType;
+    createdAt: number;
+    id: number;
+    rules: SmartContractRule[];
+    status: "ENABLED";
+    title: "通用合约";
+    type: "GENERAL";
+    updatedAt: number;
+};
+export type Res = SmartCoinContract[];
+/**
+ * 列出作品中的智能金币合约
+ * @param {MongoDBId} bizId 业务ID（如作品OID）
+ * @param {SmartContractBizType} bizType 业务类型，CREATION
+ * @returns {Promise<Res>} 智能合约列表
+ */
+export declare function getSmartContractList(bizId: MongoDBId, bizType?: SmartContractBizType): Promise<Res>;

package/dist/types/community-web/study-community/following/follow.d.ts

@@ -0,0 +1,12 @@
+import { MongoDBId } from "src/types/api";
+export declare const url = "https://community-web.ccw.site/study-community/following/follow";
+export type Req = {
+    followingOid: MongoDBId;
+};
+export type Res = "FOLLOWED";
+/**
+ * 关注创作者
+ * @param {MongoDBId} followingOid 要关注的用户 OID
+ * @returns {Promise<Res>} "FOLLOWED" 表示关注成功
+ */
+export declare function followCreator(followingOid: MongoDBId): Promise<Res>;

package/dist/types/community-web/user_package/status.d.ts

@@ -0,0 +1,13 @@
+export declare const url = "https://community-web.ccw.site/user_package/status";
+export type Req = {
+    status: boolean;
+    id: number;
+};
+export type Res = boolean;
+/**
+ * 设置用户商品状态（如佩戴/卸下头像框）
+ * @param {number} id 用户商品ID
+ * @param {boolean} status 商品状态，true为佩戴，false为卸下
+ * @returns {Promise<Res>} 设置结果
+ */
+export declare function setUserProductStatus(id: number, status: boolean): Promise<Res>;

package/dist/types/community-web/user_package/user_product.d.ts

@@ -0,0 +1,40 @@
+import { MongoDBId, CNameOssUrl } from "src/types/api";
+import { PagesRes, PageArgs } from "src/types/pages";
+import { AccountTypes } from "src/types/account";
+export declare const url = "https://community-web.ccw.site/user_package/user_product";
+export type Req = {
+    page: number;
+    perPage: number;
+    productCategory: number;
+    sortType: "ASC" | "DESC";
+};
+export type Res = PagesRes<UserProduct>;
+export type UserProduct = {
+    createdAt: number | null;
+    description: string;
+    exchangeOrderId: string | null;
+    expiredAt: number | null;
+    id: number;
+    isExpire: boolean;
+    name: string;
+    picUrl: CNameOssUrl;
+    productCategory: number;
+    productOid: MongoDBId;
+    productSource: null;
+    status: boolean;
+    updatedAt: number | null;
+    userOid: MongoDBId;
+    userType: AccountTypes;
+    validFrom: number;
+    virtualValue: CNameOssUrl;
+};
+export declare enum ProductCategory {
+    AVATAR_FRAME = 5
+}
+/**
+ * 分页获取用户商品（如头像框）
+ * @param {ProductCategory} productCategory 商品分类，默认5为头像框
+ * @param {Partial<PageArgs<SortField>>} pageArgs_ 分页参数
+ * @returns {Promise<Res>} 分页用户商品数据
+ */
+export declare function getUserProductsPage<SortField extends string>(productCategory?: ProductCategory, pageArgs_?: Partial<PageArgs<SortField>>): Promise<Res>;