@windrun-huaiin/backend-core 30.0.0 → 31.0.1

package/dist/app/api/webhook/clerk/user/route.mjs

@@ -18,10 +18,10 @@ function POST(request) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a, _b, _c;
         try {
-            // 获取原始请求体
+            // Read the raw request body.
             const rawBody = yield request.text();
             let event;
-            // 开发环境跳过签名校验
+            // Skip signature verification in development.
             if (process.env.NODE_ENV === 'development') {
                 console.log('Development mode: skipping webhook signature verification');
                 try {
@@ -33,22 +33,22 @@ function POST(request) {
                 }
             }
             else {
-                // 生产环境进行签名校验
+                // Verify the signature in production.
                 const headerPayload = yield headers();
                 const svix_id = headerPayload.get('svix-id');
                 const svix_timestamp = headerPayload.get('svix-timestamp');
                 const svix_signature = headerPayload.get('svix-signature');
-                // 如果缺少必要的header，返回错误
+                // Reject requests missing required headers.
                 if (!svix_id || !svix_timestamp || !svix_signature) {
                     return NextResponse.json({ error: 'Missing webhook headers' }, { status: 400 });
                 }
-                // 获取webhook signing secret
+                // Load the webhook signing secret.
                 const webhookSecret = process.env.CLERK_WEBHOOK_SECRET;
                 if (!webhookSecret) {
                     console.error('CLERK_WEBHOOK_SECRET is not configured');
                     return NextResponse.json({ error: 'Webhook configuration error' }, { status: 500 });
                 }
-                // 验证webhook签名
+                // Verify the webhook signature.
                 try {
                     const wh = new Webhook(webhookSecret);
                     event = wh.verify(rawBody, {
@@ -70,7 +70,7 @@ function POST(request) {
             }, event);
             let processingResult = { success: true, message: 'Event processed successfully' };
             try {
-                // 处理不同的事件类型
+                // Dispatch by event type.
                 const { type } = event;
                 switch (type) {
                     case 'user.created':
@@ -106,7 +106,7 @@ function POST(request) {
     });
 }
 /**
- * 处理用户创建事件
+ * Handle the user.created event.
  */
 function handleUserCreated(event) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -125,7 +125,7 @@ function handleUserCreated(event) {
             fingerprintId,
             userName
         });
-        // 检查必要参数
+        // Validate required fields.
         if (!fingerprintId) {
             console.error('Missing fingerprintId in webhook data, process flow error');
             return;
@@ -135,16 +135,16 @@ function handleUserCreated(event) {
             return;
         }
         try {
-            // 按fingerprintId查询该设备的所有未注销过的用户记录，注销过的记录相当于是死数据
+            // Find all non-deleted users for this device fingerprint.
             const existingUsers = yield userService.findListByFingerprintId(fingerprintId);
             if (!existingUsers || existingUsers.length === 0) {
                 console.error('Invalid fingerprintId in webhook data, process flow error');
                 return;
             }
-            // 查找email相同的记录
+            // Find an existing user with the same email.
             const sameEmailUser = existingUsers.find(user => user.email === email);
             if (sameEmailUser) {
-                // 同一账号，检查是否需要更新clerkUserId
+                // Same account; update clerkUserId if needed.
                 if (sameEmailUser.clerkUserId !== clerkUserId) {
                     yield userService.updateUser(sameEmailUser.userId, { clerkUserId, userName: userName, status: UserStatus.REGISTERED });
                     console.log(`Updated clerkUserId for user ${sameEmailUser.userId}`);
@@ -154,15 +154,15 @@ function handleUserCreated(event) {
                 }
                 return;
             }
-            // 查找匿名用户（email为空且clerkUserId为空）
+            // Find an anonymous user with no email or clerkUserId.
             const anonymousUser = existingUsers.find(user => !user.email && !user.clerkUserId && user.status === UserStatus.ANONYMOUS);
             if (anonymousUser) {
-                // 匿名用户升级
+                // Upgrade the anonymous user.
                 yield userAggregateService.upgradeToRegistered(anonymousUser.userId, email, clerkUserId, userName);
                 console.log(`Successfully upgraded anonymous user ${anonymousUser.userId} to registered user`);
                 return;
             }
-            // 同设备新账号，创建新用户
+            // New account on the same device; create a new user.
             yield userAggregateService.createNewRegisteredUser(clerkUserId, email, fingerprintId, userName);
             console.log(`Created new user for device ${fingerprintId} with email ${email}`);
         }
@@ -173,7 +173,7 @@ function handleUserCreated(event) {
     });
 }
 /**
- * 处理用户删除事件
+ * Handle the user.deleted event.
  */
 function handleUserDeleted(event) {
     return __awaiter(this, void 0, void 0, function* () {

package/dist/auth/auth-utils.d.ts

@@ -1,9 +1,6 @@
 import { NextRequest } from 'next/server';
 import { User } from '../services/database/prisma-model-type';
 import { type AuthProvider, type ProviderIdentity } from './auth-shared';
-/**
- * 认证结果类型
- */
 export interface AuthResult {
     userId: string;
     user: User;
@@ -11,48 +8,36 @@ export interface AuthResult {
     providerUserId: string;
 }
 /**
- * 从中间件设置的 Clerk ID 获取完整用户信息
+ * Fetch User's info from header field by Middleware
  */
 export declare function getAuthenticatedUser(req: NextRequest): Promise<AuthResult>;
 /**
- * 要求用户必须已认证，返回用户ID
+ * Require Auth, success back user's id
  */
 export declare function requireAuth(req: NextRequest): Promise<string>;
 /**
- * 要求用户必须已认证，返回完整用户信息
+ * Require Auth, success back user's info
  */
 export declare function requireAuthWithUser(req: NextRequest): Promise<AuthResult>;
 /**
- * 服务端场景下获取当前已认证身份（如果存在）
- * 适用于只依赖登录态、不需要查询业务用户的逻辑
+ * Only use in server side
+ * Server Component / Server Action, just need user's login status
  */
 export declare function getOptionalServerAuthIdentity(): Promise<ProviderIdentity | null>;
 /**
- * 服务端场景下获取当前已认证用户（如果存在）
- * 适用于 Server Component / Server Action 中基于登录态控制展示的逻辑
+ * Only use in server side
+ * Server Component / Server Action, need user's login status and user's data, will check db
  */
 export declare function getOptionalServerAuthUser(): Promise<AuthResult | null>;
 /**
- * API Route版本的认证工具函数
+ * API Route Auth Util
  */
 export declare class ApiAuthUtils {
     private req;
     constructor(req: NextRequest);
-    /**
-     * 要求用户必须已认证，返回用户ID
-     */
     requireAuth(): Promise<string>;
-    /**
-     * 要求用户必须已认证，返回完整用户信息
-     */
     requireAuthWithUser(): Promise<AuthResult>;
-    /**
-     * 获取用户ID（如果已认证）
-     */
     getUserId(): Promise<string | null>;
-    /**
-     * 获取完整用户信息（如果已认证）
-     */
     getUser(): Promise<AuthResult | null>;
 }
 //# sourceMappingURL=auth-utils.d.ts.map

package/dist/auth/auth-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-utils.d.ts","sourceRoot":"","sources":["../../src/auth/auth-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,IAAI,EAAE,MAAM,wCAAwC,CAAC;AAC9D,OAAO,EAA6B,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEpG;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAuBhF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAGnE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAE/E;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAetF;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAsB5E;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAc;gBAEb,GAAG,EAAE,WAAW;IAI5B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAIpC;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,UAAU,CAAC;IAIhD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASzC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAO5C"}
+{"version":3,"file":"auth-utils.d.ts","sourceRoot":"","sources":["../../src/auth/auth-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,IAAI,EAAE,MAAM,wCAAwC,CAAC;AAC9D,OAAO,EAA6B,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEpG,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAuBhF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAGnE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAE/E;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAetF;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAsB5E;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAc;gBAEb,GAAG,EAAE,WAAW;IAItB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAI9B,mBAAmB,IAAI,OAAO,CAAC,UAAU,CAAC;IAI1C,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASnC,OAAO,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAO5C"}

package/dist/auth/auth-utils.js

@@ -8,7 +8,7 @@ require('../services/database/credit.service.js');
 var authShared = require('./auth-shared.js');
 
 /**
- * 从中间件设置的 Clerk ID 获取完整用户信息
+ * Fetch User's info from header field by Middleware
  */
 function getAuthenticatedUser(req) {
     return tslib.__awaiter(this, void 0, void 0, function* () {
@@ -36,7 +36,7 @@ function getAuthenticatedUser(req) {
     });
 }
 /**
- * 要求用户必须已认证，返回用户ID
+ * Require Auth, success back user's id
  */
 function requireAuth(req) {
     return tslib.__awaiter(this, void 0, void 0, function* () {
@@ -45,7 +45,7 @@ function requireAuth(req) {
     });
 }
 /**
- * 要求用户必须已认证，返回完整用户信息
+ * Require Auth, success back user's info
  */
 function requireAuthWithUser(req) {
     return tslib.__awaiter(this, void 0, void 0, function* () {
@@ -53,8 +53,8 @@ function requireAuthWithUser(req) {
     });
 }
 /**
- * 服务端场景下获取当前已认证身份（如果存在）
- * 适用于只依赖登录态、不需要查询业务用户的逻辑
+ * Only use in server side
+ * Server Component / Server Action, just need user's login status
  */
 function getOptionalServerAuthIdentity() {
     return tslib.__awaiter(this, void 0, void 0, function* () {
@@ -75,8 +75,8 @@ function getOptionalServerAuthIdentity() {
     });
 }
 /**
- * 服务端场景下获取当前已认证用户（如果存在）
- * 适用于 Server Component / Server Action 中基于登录态控制展示的逻辑
+ * Only use in server side
+ * Server Component / Server Action, need user's login status and user's data, will check db
  */
 function getOptionalServerAuthUser() {
     return tslib.__awaiter(this, void 0, void 0, function* () {
@@ -103,31 +103,22 @@ function getOptionalServerAuthUser() {
     });
 }
 /**
- * API Route版本的认证工具函数
+ * API Route Auth Util
  */
 class ApiAuthUtils {
     constructor(req) {
         this.req = req;
     }
-    /**
-     * 要求用户必须已认证，返回用户ID
-     */
     requireAuth() {
         return tslib.__awaiter(this, void 0, void 0, function* () {
             return yield requireAuth(this.req);
         });
     }
-    /**
-     * 要求用户必须已认证，返回完整用户信息
-     */
     requireAuthWithUser() {
         return tslib.__awaiter(this, void 0, void 0, function* () {
             return yield requireAuthWithUser(this.req);
         });
     }
-    /**
-     * 获取用户ID（如果已认证）
-     */
     getUserId() {
         return tslib.__awaiter(this, void 0, void 0, function* () {
             try {
@@ -139,9 +130,6 @@ class ApiAuthUtils {
             }
         });
     }
-    /**
-     * 获取完整用户信息（如果已认证）
-     */
     getUser() {
         return tslib.__awaiter(this, void 0, void 0, function* () {
             try {

package/dist/auth/auth-utils.mjs

@@ -6,7 +6,7 @@ import '../services/database/credit.service.mjs';
 import { AUTH_HEADERS, AUTH_ERRORS } from './auth-shared.mjs';
 
 /**
- * 从中间件设置的 Clerk ID 获取完整用户信息
+ * Fetch User's info from header field by Middleware
  */
 function getAuthenticatedUser(req) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -34,7 +34,7 @@ function getAuthenticatedUser(req) {
     });
 }
 /**
- * 要求用户必须已认证，返回用户ID
+ * Require Auth, success back user's id
  */
 function requireAuth(req) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -43,7 +43,7 @@ function requireAuth(req) {
     });
 }
 /**
- * 要求用户必须已认证，返回完整用户信息
+ * Require Auth, success back user's info
  */
 function requireAuthWithUser(req) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -51,8 +51,8 @@ function requireAuthWithUser(req) {
     });
 }
 /**
- * 服务端场景下获取当前已认证身份（如果存在）
- * 适用于只依赖登录态、不需要查询业务用户的逻辑
+ * Only use in server side
+ * Server Component / Server Action, just need user's login status
  */
 function getOptionalServerAuthIdentity() {
     return __awaiter(this, void 0, void 0, function* () {
@@ -73,8 +73,8 @@ function getOptionalServerAuthIdentity() {
     });
 }
 /**
- * 服务端场景下获取当前已认证用户（如果存在）
- * 适用于 Server Component / Server Action 中基于登录态控制展示的逻辑
+ * Only use in server side
+ * Server Component / Server Action, need user's login status and user's data, will check db
  */
 function getOptionalServerAuthUser() {
     return __awaiter(this, void 0, void 0, function* () {
@@ -101,31 +101,22 @@ function getOptionalServerAuthUser() {
     });
 }
 /**
- * API Route版本的认证工具函数
+ * API Route Auth Util
  */
 class ApiAuthUtils {
     constructor(req) {
         this.req = req;
     }
-    /**
-     * 要求用户必须已认证，返回用户ID
-     */
     requireAuth() {
         return __awaiter(this, void 0, void 0, function* () {
             return yield requireAuth(this.req);
         });
     }
-    /**
-     * 要求用户必须已认证，返回完整用户信息
-     */
     requireAuthWithUser() {
         return __awaiter(this, void 0, void 0, function* () {
             return yield requireAuthWithUser(this.req);
         });
     }
-    /**
-     * 获取用户ID（如果已认证）
-     */
     getUserId() {
         return __awaiter(this, void 0, void 0, function* () {
             try {
@@ -137,9 +128,6 @@ class ApiAuthUtils {
             }
         });
     }
-    /**
-     * 获取完整用户信息（如果已认证）
-     */
     getUser() {
         return __awaiter(this, void 0, void 0, function* () {
             try {

package/dist/lib/money-price-config.d.ts

@@ -1,47 +1,47 @@
 import { MoneyPriceConfig, PaymentProviderConfig, EnhancePricePlan } from '@windrun-huaiin/third-ui/main/server';
 export declare const moneyPriceConfig: MoneyPriceConfig;
 /**
- * 获取当前激活的支付供应商配置
+ * Get the currently active payment provider configuration.
  *
- * 🔒 安全设计：
- * - wrapper函数隐藏moneyPriceConfig
- * - util层负责从config中提取激活的provider配置
- * - 外部只能通过这个wrapper访问，看不到config对象
+ * Security design:
+ * - Wrapper functions keep moneyPriceConfig private.
+ * - Utility functions extract the active provider configuration from the config.
+ * - External callers can access only this wrapper, not the full config object.
  *
- * @returns 当前激活的支付供应商配置
+ * @returns The currently active payment provider configuration.
  */
 export declare function getActiveProviderConfig(): PaymentProviderConfig;
 /**
- * 根据 priceId 获取对应的积分数量
+ * Get the credit amount for a price ID.
  *
- * 🔒 安全设计：
- * - wrapper函数隐藏moneyPriceConfig
- * - util层负责解析config并提取结果
- * - 外部只能通过这个wrapper访问，看不到config对象
+ * Security design:
+ * - Wrapper functions keep moneyPriceConfig private.
+ * - Utility functions parse the config and extract the result.
+ * - External callers can access only this wrapper, not the full config object.
  *
- * @param priceId - 查询的价格ID
- * @param _provider - 保留参数（向后兼容），暂未使用
- * @returns 对应的积分数量，或null
+ * @param priceId - Price ID to query.
+ * @param _provider - Reserved for backward compatibility; currently unused.
+ * @returns The matching credit amount, or null.
  */
 export declare function getCreditsFromPriceId(priceId?: string, _provider?: string): number | null;
 /**
- * 根据查询参数获取价格配置
+ * Get price configuration by query parameters.
  *
- * 支持三种查询方式：
- * 1. 按 priceId 查询：getPriceConfig(priceId='price_xxx')
- * 2. 按 plan 和 billingType 查询：getPriceConfig(undefined, 'P2', 'monthly')
- * 3. 按 plan 查询：getPriceConfig(undefined, 'P2')
+ * Supported query modes:
+ * 1. By priceId: getPriceConfig(priceId='price_xxx')
+ * 2. By plan and billingType: getPriceConfig(undefined, 'P2', 'monthly')
+ * 3. By plan: getPriceConfig(undefined, 'P2')
  *
- * 🔒 安全设计：
- * - wrapper函数隐藏moneyPriceConfig
- * - util层负责解析config并提取匹配的结果
- * - 外部只能通过这个wrapper访问，看不到config对象
+ * Security design:
+ * - Wrapper functions keep moneyPriceConfig private.
+ * - Utility functions parse the config and extract the matching result.
+ * - External callers can access only this wrapper, not the full config object.
  *
- * @param priceId - 查询的价格ID（可选）
- * @param plan - 查询的套餐名称如'P2'、'U3'（可选）
- * @param billingType - 查询的计费类型如'monthly'、'yearly'（可选）
- * @param _provider - 保留参数（向后兼容），暂未使用
- * @returns 匹配的价格配置，包含计算好的元数据（priceName、description、interval）
+ * @param priceId - Optional price ID to query.
+ * @param plan - Optional plan name, such as 'P2' or 'U3'.
+ * @param billingType - Optional billing type, such as 'monthly' or 'yearly'.
+ * @param _provider - Reserved for backward compatibility; currently unused.
+ * @returns The matching price config with derived metadata: priceName, description, and interval.
  */
 export declare function getPriceConfig(priceId?: string, plan?: string, billingType?: string, _provider?: string): (EnhancePricePlan & {
     priceName: string;

package/dist/lib/money-price-config.js

@@ -7,7 +7,7 @@ const moneyPriceConfig = {
         stripe: {
             provider: 'stripe',
             enabled: true,
-            // 订阅模式产品
+            // Subscription products
             subscriptionProducts: {
                 F1: {
                     key: 'F1',
@@ -65,7 +65,7 @@ const moneyPriceConfig = {
                     }
                 }
             },
-            // 积分包产品
+            // Credit pack products
             creditPackProducts: {
                 F1: {
                     key: 'F1',
@@ -98,53 +98,53 @@ const moneyPriceConfig = {
         minFeaturesCount: 4
     }
 };
-// ============ 应用层wrapper - 隐藏moneyPriceConfig细节 ============
+// ============ Application-level wrappers that hide moneyPriceConfig details ============
 /**
- * 获取当前激活的支付供应商配置
+ * Get the currently active payment provider configuration.
  *
- * 🔒 安全设计：
- * - wrapper函数隐藏moneyPriceConfig
- * - util层负责从config中提取激活的provider配置
- * - 外部只能通过这个wrapper访问，看不到config对象
+ * Security design:
+ * - Wrapper functions keep moneyPriceConfig private.
+ * - Utility functions extract the active provider configuration from the config.
+ * - External callers can access only this wrapper, not the full config object.
  *
- * @returns 当前激活的支付供应商配置
+ * @returns The currently active payment provider configuration.
  */
 function getActiveProviderConfig() {
     return server.getActiveProviderConfigUtil(moneyPriceConfig);
 }
 /**
- * 根据 priceId 获取对应的积分数量
+ * Get the credit amount for a price ID.
  *
- * 🔒 安全设计：
- * - wrapper函数隐藏moneyPriceConfig
- * - util层负责解析config并提取结果
- * - 外部只能通过这个wrapper访问，看不到config对象
+ * Security design:
+ * - Wrapper functions keep moneyPriceConfig private.
+ * - Utility functions parse the config and extract the result.
+ * - External callers can access only this wrapper, not the full config object.
  *
- * @param priceId - 查询的价格ID
- * @param _provider - 保留参数（向后兼容），暂未使用
- * @returns 对应的积分数量，或null
+ * @param priceId - Price ID to query.
+ * @param _provider - Reserved for backward compatibility; currently unused.
+ * @returns The matching credit amount, or null.
  */
 function getCreditsFromPriceId(priceId, _provider) {
     return server.getCreditsFromPriceIdUtil(priceId, moneyPriceConfig);
 }
 /**
- * 根据查询参数获取价格配置
+ * Get price configuration by query parameters.
  *
- * 支持三种查询方式：
- * 1. 按 priceId 查询：getPriceConfig(priceId='price_xxx')
- * 2. 按 plan 和 billingType 查询：getPriceConfig(undefined, 'P2', 'monthly')
- * 3. 按 plan 查询：getPriceConfig(undefined, 'P2')
+ * Supported query modes:
+ * 1. By priceId: getPriceConfig(priceId='price_xxx')
+ * 2. By plan and billingType: getPriceConfig(undefined, 'P2', 'monthly')
+ * 3. By plan: getPriceConfig(undefined, 'P2')
  *
- * 🔒 安全设计：
- * - wrapper函数隐藏moneyPriceConfig
- * - util层负责解析config并提取匹配的结果
- * - 外部只能通过这个wrapper访问，看不到config对象
+ * Security design:
+ * - Wrapper functions keep moneyPriceConfig private.
+ * - Utility functions parse the config and extract the matching result.
+ * - External callers can access only this wrapper, not the full config object.
  *
- * @param priceId - 查询的价格ID（可选）
- * @param plan - 查询的套餐名称如'P2'、'U3'（可选）
- * @param billingType - 查询的计费类型如'monthly'、'yearly'（可选）
- * @param _provider - 保留参数（向后兼容），暂未使用
- * @returns 匹配的价格配置，包含计算好的元数据（priceName、description、interval）
+ * @param priceId - Optional price ID to query.
+ * @param plan - Optional plan name, such as 'P2' or 'U3'.
+ * @param billingType - Optional billing type, such as 'monthly' or 'yearly'.
+ * @param _provider - Reserved for backward compatibility; currently unused.
+ * @returns The matching price config with derived metadata: priceName, description, and interval.
  */
 function getPriceConfig(priceId, plan, billingType, _provider) {
     return server.getPriceConfigUtil(priceId, plan, billingType, moneyPriceConfig);

package/dist/lib/money-price-config.mjs

@@ -5,7 +5,7 @@ const moneyPriceConfig = {
         stripe: {
             provider: 'stripe',
             enabled: true,
-            // 订阅模式产品
+            // Subscription products
             subscriptionProducts: {
                 F1: {
                     key: 'F1',
@@ -63,7 +63,7 @@ const moneyPriceConfig = {
                     }
                 }
             },
-            // 积分包产品
+            // Credit pack products
             creditPackProducts: {
                 F1: {
                     key: 'F1',
@@ -96,53 +96,53 @@ const moneyPriceConfig = {
         minFeaturesCount: 4
     }
 };
-// ============ 应用层wrapper - 隐藏moneyPriceConfig细节 ============
+// ============ Application-level wrappers that hide moneyPriceConfig details ============
 /**
- * 获取当前激活的支付供应商配置
+ * Get the currently active payment provider configuration.
  *
- * 🔒 安全设计：
- * - wrapper函数隐藏moneyPriceConfig
- * - util层负责从config中提取激活的provider配置
- * - 外部只能通过这个wrapper访问，看不到config对象
+ * Security design:
+ * - Wrapper functions keep moneyPriceConfig private.
+ * - Utility functions extract the active provider configuration from the config.
+ * - External callers can access only this wrapper, not the full config object.
  *
- * @returns 当前激活的支付供应商配置
+ * @returns The currently active payment provider configuration.
  */
 function getActiveProviderConfig() {
     return getActiveProviderConfigUtil(moneyPriceConfig);
 }
 /**
- * 根据 priceId 获取对应的积分数量
+ * Get the credit amount for a price ID.
  *
- * 🔒 安全设计：
- * - wrapper函数隐藏moneyPriceConfig
- * - util层负责解析config并提取结果
- * - 外部只能通过这个wrapper访问，看不到config对象
+ * Security design:
+ * - Wrapper functions keep moneyPriceConfig private.
+ * - Utility functions parse the config and extract the result.
+ * - External callers can access only this wrapper, not the full config object.
  *
- * @param priceId - 查询的价格ID
- * @param _provider - 保留参数（向后兼容），暂未使用
- * @returns 对应的积分数量，或null
+ * @param priceId - Price ID to query.
+ * @param _provider - Reserved for backward compatibility; currently unused.
+ * @returns The matching credit amount, or null.
  */
 function getCreditsFromPriceId(priceId, _provider) {
     return getCreditsFromPriceIdUtil(priceId, moneyPriceConfig);
 }
 /**
- * 根据查询参数获取价格配置
+ * Get price configuration by query parameters.
  *
- * 支持三种查询方式：
- * 1. 按 priceId 查询：getPriceConfig(priceId='price_xxx')
- * 2. 按 plan 和 billingType 查询：getPriceConfig(undefined, 'P2', 'monthly')
- * 3. 按 plan 查询：getPriceConfig(undefined, 'P2')
+ * Supported query modes:
+ * 1. By priceId: getPriceConfig(priceId='price_xxx')
+ * 2. By plan and billingType: getPriceConfig(undefined, 'P2', 'monthly')
+ * 3. By plan: getPriceConfig(undefined, 'P2')
  *
- * 🔒 安全设计：
- * - wrapper函数隐藏moneyPriceConfig
- * - util层负责解析config并提取匹配的结果
- * - 外部只能通过这个wrapper访问，看不到config对象
+ * Security design:
+ * - Wrapper functions keep moneyPriceConfig private.
+ * - Utility functions parse the config and extract the matching result.
+ * - External callers can access only this wrapper, not the full config object.
  *
- * @param priceId - 查询的价格ID（可选）
- * @param plan - 查询的套餐名称如'P2'、'U3'（可选）
- * @param billingType - 查询的计费类型如'monthly'、'yearly'（可选）
- * @param _provider - 保留参数（向后兼容），暂未使用
- * @returns 匹配的价格配置，包含计算好的元数据（priceName、description、interval）
+ * @param priceId - Optional price ID to query.
+ * @param plan - Optional plan name, such as 'P2' or 'U3'.
+ * @param billingType - Optional billing type, such as 'monthly' or 'yearly'.
+ * @param _provider - Reserved for backward compatibility; currently unused.
+ * @returns The matching price config with derived metadata: priceName, description, and interval.
  */
 function getPriceConfig(priceId, plan, billingType, _provider) {
     return getPriceConfigUtil(priceId, plan, billingType, moneyPriceConfig);