@windrun-huaiin/backend-core 30.0.0 → 31.0.0

package/dist/prisma/prisma.mjs

@@ -1,5 +1,5 @@
 const globalForPrisma = globalThis;
-// ==================== 日志配置 ====================
+// ==================== Logging Configuration ====================
 const getLogConfig = () => {
     if (process.env.PRISMA_DEBUG === 'true') {
         return [
@@ -65,41 +65,40 @@ function registerDevelopmentQueryLogger(prismaClient, instanceId) {
         const listenerId = `listener_${Date.now()}_${Math.random().toString(36).substr(2, 5)}`;
         globalForPrisma[ID_KEY] = listenerId;
         console.log(`Prisma Query Logger Registered | Listener ID: ${listenerId} | Instance ID: ${instanceId}`);
-        // --- 自定义SQL拼接 ---
+        // --- Custom SQL interpolation ---
         const interpolate = (query, params) => {
-            // 1. 【核心修改】：安全检查和参数解析
+            // 1. Validate and parse parameters safely.
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             let parameters = [];
             try {
-                // 尝试解析 params 字符串
-                // 如果 params 是空字符串 ""，或者不是有效的 JSON，这里会捕获错误
+                // Parse the params string. Empty strings or invalid JSON are handled by the catch block.
                 parameters = params && params.length > 0 ? JSON.parse(params) : [];
                 // eslint-disable-next-line unused-imports/no-unused-vars
             }
             catch (e) {
-                // 如果无法解析，则直接返回原始查询，跳过替换
+                // If parsing fails, return the original query without interpolation.
                 return query;
             }
-            // 确保 parameters 是一个数组
+            // Ensure parameters is an array.
             if (!Array.isArray(parameters)) {
-                console.warn('Prisma params解析结果不是数组，跳过参数替换。Result:', parameters);
+                console.warn('Prisma params did not parse to an array; skipping parameter interpolation. Result:', parameters);
                 return query;
             }
-            // 如果没有参数，直接返回查询
+            // If there are no parameters, return the query as-is.
             if (parameters.length === 0) {
                 return query;
             }
-            // 2. 将参数列表的值进行安全的字符串化处理
+            // 2. Safely stringify parameter values.
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const safeValues = parameters.map((p) => {
                 if (p === null)
                     return 'NULL';
-                // 对字符串类型的值加上单引号并转义（这是SQL安全的关键）
+                // Quote and escape string values for readable SQL logging.
                 if (typeof p === 'string')
                     return `'${p.replace(/'/g, "''")}'`;
-                return p; // 数字、布尔值等直接返回
+                return p; // Numbers, booleans, and similar values can be returned directly.
             });
-            // 3. 循环替换 $1, $2, ...
+            // 3. Replace $1, $2, ... placeholders.
             let sql = query;
             for (let i = 0; i < safeValues.length; i++) {
                 const placeholder = new RegExp('\\$' + (i + 1) + '(?!\\d)', 'g');
@@ -112,20 +111,20 @@ function registerDevelopmentQueryLogger(prismaClient, instanceId) {
             const slow = ms >= 200 ? '🐌 SLOW SQL ' : '🚀 SQL';
             const interpolatedSql = interpolate(event.query, event.params);
             const clean = interpolatedSql
-                .replace(/"[^"]+"\./g, '') // 去 "表".
-                .replace(/= '([^']+)'/g, `= '$1'`) // 已经替换成单引号，此处可以优化
-                .replace(/"/g, ''); // 彻底灭双引号
+                .replace(/"[^"]+"\./g, '') // Remove "table". prefixes.
+                .replace(/= '([^']+)'/g, `= '$1'`) // Keep normalized quoted values.
+                .replace(/"/g, ''); // Remove remaining double quotes.
             console.log('─'.repeat(60));
             console.log(`Prisma Instance ID: ${instanceId} | Listener ID: ${listenerId}`);
             console.log(`${clean};`);
-            console.log(`⏰ 耗时: ${ms}ms, ${slow}`);
+            console.log(`Duration: ${ms}ms, ${slow}`);
         };
-        // 注册包装后的 handler
+        // Register the wrapped handler.
         (_a = prismaClient.$on) === null || _a === void 0 ? void 0 : _a.call(prismaClient, 'query', wrappedHandler);
         globalForPrisma[REGISTERED_KEY] = true;
     }
 }
-// ==================== 便捷方法, 入参事务客户端不存在或者不传, 就返回全局非事务客户端 ====================
+// ==================== Client Helper: fall back to the global non-transaction client when no transaction client is provided ====================
 function checkAndFallbackWithNonTCClient(tx) {
     return tx !== null && tx !== void 0 ? tx : getBackendCorePrisma();
 }

package/dist/services/aggregate/billing.aggregate.service.js

@@ -14,7 +14,7 @@ class BillingAggregateService {
             yield prismaTransactionUtil.runInTransaction((tx) => tslib.__awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h;
                 const now = new Date();
-                // 订阅截止时间统一为到期日最后1s
+                // Set subscription expiry to the last second of the expiration date
                 const originSubPeriodEnd = context.periodEnd;
                 const specialEnd = originSubPeriodEnd ? new Date(originSubPeriodEnd.setHours(23, 59, 59, 999)) : originSubPeriodEnd;
                 const updatedSubscription = yield subscription_service.subscriptionService.updateSubscription(context.subIdKey, {
@@ -132,7 +132,7 @@ class BillingAggregateService {
                     paidEmail: context.paidEmail,
                     payUpdatedAt: new Date(),
                 }, tx);
-                // 订阅截止时间统一为到期日最后1s
+                // Set subscription expiry to the last second of the expiration date
                 const originSubPeriodEnd = context.periodEnd;
                 const specialEnd = originSubPeriodEnd ? new Date(originSubPeriodEnd.setHours(23, 59, 59, 999)) : originSubPeriodEnd;
                 yield subscription_service.subscriptionService.updateSubscription(context.subIdKey, {
@@ -218,7 +218,7 @@ class BillingAggregateService {
         return tslib.__awaiter(this, void 0, void 0, function* () {
             yield prismaTransactionUtil.runInTransaction((tx) => tslib.__awaiter(this, void 0, void 0, function* () {
                 if (params.isUserCancel) {
-                    // 记录用户取消订阅的时间信息
+                    // Record the time when the user unsubscribes
                     yield transaction_service.transactionService.update(params.orderId, {
                         subLastTryCancelAt: new Date(),
                     }, tx);
@@ -236,14 +236,14 @@ class BillingAggregateService {
         return tslib.__awaiter(this, void 0, void 0, function* () {
             yield prismaTransactionUtil.runInTransaction((tx) => tslib.__awaiter(this, void 0, void 0, function* () {
                 var _a;
-                // 更新订单, 记录取消信息
+                // Update the order and log cancellation details
                 yield transaction_service.transactionService.update(context.orderId, {
                     subPeriodCanceledAt: context.canceledAt,
                     subCancellationDetail: (_a = context.cancellationDetail) !== null && _a !== void 0 ? _a : undefined
                 }, tx);
-                // 更新订阅信息
+                // Update subscription information
                 yield subscription_service.subscriptionService.updateStatus(context.subIdKey, constants.SubscriptionStatus.CANCELED, tx);
-                // 清理积分并留痕
+                // Clear credits and keep audit trail
                 yield credit_service.creditService.purgePaidCredit(context.userId, 'cancel_subscription_purge', context.orderId, tx);
             }));
         });

package/dist/services/aggregate/billing.aggregate.service.mjs

@@ -12,7 +12,7 @@ class BillingAggregateService {
             yield runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h;
                 const now = new Date();
-                // 订阅截止时间统一为到期日最后1s
+                // Set subscription expiry to the last second of the expiration date
                 const originSubPeriodEnd = context.periodEnd;
                 const specialEnd = originSubPeriodEnd ? new Date(originSubPeriodEnd.setHours(23, 59, 59, 999)) : originSubPeriodEnd;
                 const updatedSubscription = yield subscriptionService.updateSubscription(context.subIdKey, {
@@ -130,7 +130,7 @@ class BillingAggregateService {
                     paidEmail: context.paidEmail,
                     payUpdatedAt: new Date(),
                 }, tx);
-                // 订阅截止时间统一为到期日最后1s
+                // Set subscription expiry to the last second of the expiration date
                 const originSubPeriodEnd = context.periodEnd;
                 const specialEnd = originSubPeriodEnd ? new Date(originSubPeriodEnd.setHours(23, 59, 59, 999)) : originSubPeriodEnd;
                 yield subscriptionService.updateSubscription(context.subIdKey, {
@@ -216,7 +216,7 @@ class BillingAggregateService {
         return __awaiter(this, void 0, void 0, function* () {
             yield runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
                 if (params.isUserCancel) {
-                    // 记录用户取消订阅的时间信息
+                    // Record the time when the user unsubscribes
                     yield transactionService.update(params.orderId, {
                         subLastTryCancelAt: new Date(),
                     }, tx);
@@ -234,14 +234,14 @@ class BillingAggregateService {
         return __awaiter(this, void 0, void 0, function* () {
             yield runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
                 var _a;
-                // 更新订单, 记录取消信息
+                // Update the order and log cancellation details
                 yield transactionService.update(context.orderId, {
                     subPeriodCanceledAt: context.canceledAt,
                     subCancellationDetail: (_a = context.cancellationDetail) !== null && _a !== void 0 ? _a : undefined
                 }, tx);
-                // 更新订阅信息
+                // Update subscription information
                 yield subscriptionService.updateStatus(context.subIdKey, SubscriptionStatus.CANCELED, tx);
-                // 清理积分并留痕
+                // Clear credits and keep audit trail
                 yield creditService.purgePaidCredit(context.userId, 'cancel_subscription_purge', context.orderId, tx);
             }));
         });

package/dist/services/aggregate/user.aggregate.service.d.ts

@@ -7,17 +7,17 @@ export declare class UserAggregateService {
         credit: Credit;
     }>;
     /**
-     * 创建新的注册用户
+     * Create a new registered user
      *
-     * 初始化步骤（与 credit 平行）：
-     * 1. 创建 User 记录
-     * 2. 初始化 Credit 记录（免费积分）
-     * 3. 初始化 Subscription 记录（占位符，status=INCOMPLETE）
-     * 4. 记录 CreditUsage（审计）
+     * Initialization steps (parallel to credit):
+     * 1. Create User record
+     * 2. Initialize Credit record (free credits)
+     * 3. Initialize Subscription record (placeholder, status=INCOMPLETE)
+     * 4. Record CreditUsage (audit)
      *
-     * 后续当用户通过 Stripe 订阅时：
-     * - session.completed 或 invoice.paid 会 UPDATE subscription 记录
-     * - 不需要 CREATE，只需 UPDATE 确保逻辑一致
+     * When the user subscribes via Stripe later:
+     * - session.completed or invoice.paid will UPDATE the subscription record
+     * - No CREATE needed, only UPDATE to ensure logical consistency
      */
     createNewRegisteredUser(clerkUserId: string, email?: string, fingerprintId?: string, userName?: string, sourceRef?: CoreJsonValue): Promise<{
         newUser: User;

package/dist/services/aggregate/user.aggregate.service.js

@@ -32,17 +32,17 @@ class UserAggregateService {
         });
     }
     /**
-     * 创建新的注册用户
+     * Create a new registered user
      *
-     * 初始化步骤（与 credit 平行）：
-     * 1. 创建 User 记录
-     * 2. 初始化 Credit 记录（免费积分）
-     * 3. 初始化 Subscription 记录（占位符，status=INCOMPLETE）
-     * 4. 记录 CreditUsage（审计）
+     * Initialization steps (parallel to credit):
+     * 1. Create User record
+     * 2. Initialize Credit record (free credits)
+     * 3. Initialize Subscription record (placeholder, status=INCOMPLETE)
+     * 4. Record CreditUsage (audit)
      *
-     * 后续当用户通过 Stripe 订阅时：
-     * - session.completed 或 invoice.paid 会 UPDATE subscription 记录
-     * - 不需要 CREATE，只需 UPDATE 确保逻辑一致
+     * When the user subscribes via Stripe later:
+     * - session.completed or invoice.paid will UPDATE the subscription record
+     * - No CREATE needed, only UPDATE to ensure logical consistency
      */
     createNewRegisteredUser(clerkUserId, email, fingerprintId, userName, sourceRef) {
         return tslib.__awaiter(this, void 0, void 0, function* () {
@@ -68,7 +68,7 @@ class UserAggregateService {
             }));
         });
     }
-    // 注意积分审查日志的处理
+    // Note: Handle credit review logs
     upgradeToRegistered(userId, email, clerkUserId, userName) {
         return tslib.__awaiter(this, void 0, void 0, function* () {
             return prismaTransactionUtil.runInTransaction((tx) => tslib.__awaiter(this, void 0, void 0, function* () {
@@ -77,9 +77,9 @@ class UserAggregateService {
                     clerkUserId,
                     userName
                 }, tx);
-                // 先清空匿名积分并审计日志留痕
+                // Clear anonymous credits first and audit for traceability
                 yield credit_service.creditService.purgeFreeCredit(userId, 'user_registered_purge', userId, tx);
-                // 再初始化完成注册获得免费积分
+                // Then initialize free credits upon successful registration
                 const credit = yield credit_service.creditService.initializeCreditWithFree({
                     userId: updateUser.userId,
                     feature: 'user_registration_init',
@@ -95,20 +95,20 @@ class UserAggregateService {
     handleUserUnregister(clerkUserId) {
         return tslib.__awaiter(this, void 0, void 0, function* () {
             return prismaTransactionUtil.runInTransaction((tx) => tslib.__awaiter(this, void 0, void 0, function* () {
-                // 根据clerkUserId查找用户
+                // query DB user
                 const user = yield user_service.userService.findByClerkUserId(clerkUserId, tx);
                 if (!user) {
                     console.log(`User with clerkUserId ${clerkUserId} not found`);
                     return null;
                 }
                 const userId = user.userId;
-                // 更改用户状态，保留user信息尤其是FingerprintId，防止反复注册薅羊毛
+                // Update user status and retain user info (especially FingerprintId) to prevent repeated registration abuse
                 yield user_service.userService.unregister(user.userId, tx);
-                // 清空积分
+                // Clear credits
                 yield credit_service.creditService.purgeCredit(userId, 'soft_delete_user', userId, tx);
                 const subscription = yield subscription_service.subscriptionService.getActiveSubscription(userId, tx);
                 if (subscription) {
-                    // 如果有订阅信息，则要更新
+                    // Update subscription info if it exists
                     yield subscription_service.subscriptionService.cancelSubscription(subscription.id, true, tx);
                 }
                 return user.userId;

package/dist/services/aggregate/user.aggregate.service.mjs

@@ -30,17 +30,17 @@ class UserAggregateService {
         });
     }
     /**
-     * 创建新的注册用户
+     * Create a new registered user
      *
-     * 初始化步骤（与 credit 平行）：
-     * 1. 创建 User 记录
-     * 2. 初始化 Credit 记录（免费积分）
-     * 3. 初始化 Subscription 记录（占位符，status=INCOMPLETE）
-     * 4. 记录 CreditUsage（审计）
+     * Initialization steps (parallel to credit):
+     * 1. Create User record
+     * 2. Initialize Credit record (free credits)
+     * 3. Initialize Subscription record (placeholder, status=INCOMPLETE)
+     * 4. Record CreditUsage (audit)
      *
-     * 后续当用户通过 Stripe 订阅时：
-     * - session.completed 或 invoice.paid 会 UPDATE subscription 记录
-     * - 不需要 CREATE，只需 UPDATE 确保逻辑一致
+     * When the user subscribes via Stripe later:
+     * - session.completed or invoice.paid will UPDATE the subscription record
+     * - No CREATE needed, only UPDATE to ensure logical consistency
      */
     createNewRegisteredUser(clerkUserId, email, fingerprintId, userName, sourceRef) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -66,7 +66,7 @@ class UserAggregateService {
             }));
         });
     }
-    // 注意积分审查日志的处理
+    // Note: Handle credit review logs
     upgradeToRegistered(userId, email, clerkUserId, userName) {
         return __awaiter(this, void 0, void 0, function* () {
             return runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
@@ -75,9 +75,9 @@ class UserAggregateService {
                     clerkUserId,
                     userName
                 }, tx);
-                // 先清空匿名积分并审计日志留痕
+                // Clear anonymous credits first and audit for traceability
                 yield creditService.purgeFreeCredit(userId, 'user_registered_purge', userId, tx);
-                // 再初始化完成注册获得免费积分
+                // Then initialize free credits upon successful registration
                 const credit = yield creditService.initializeCreditWithFree({
                     userId: updateUser.userId,
                     feature: 'user_registration_init',
@@ -93,20 +93,20 @@ class UserAggregateService {
     handleUserUnregister(clerkUserId) {
         return __awaiter(this, void 0, void 0, function* () {
             return runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
-                // 根据clerkUserId查找用户
+                // query DB user
                 const user = yield userService.findByClerkUserId(clerkUserId, tx);
                 if (!user) {
                     console.log(`User with clerkUserId ${clerkUserId} not found`);
                     return null;
                 }
                 const userId = user.userId;
-                // 更改用户状态，保留user信息尤其是FingerprintId，防止反复注册薅羊毛
+                // Update user status and retain user info (especially FingerprintId) to prevent repeated registration abuse
                 yield userService.unregister(user.userId, tx);
-                // 清空积分
+                // Clear credits
                 yield creditService.purgeCredit(userId, 'soft_delete_user', userId, tx);
                 const subscription = yield subscriptionService.getActiveSubscription(userId, tx);
                 if (subscription) {
-                    // 如果有订阅信息，则要更新
+                    // Update subscription info if it exists
                     yield subscriptionService.cancelSubscription(subscription.id, true, tx);
                 }
                 return user.userId;

package/dist/services/database/constants.js

@@ -3,91 +3,91 @@
 // Database Field Enums
 // Keep in sync with DB CHECK constraints
 const UserStatus = {
-    // 匿名用户
+    // Anonymous user
     ANONYMOUS: 'anonymous',
-    // 注册用户
+    // Registered user
     REGISTERED: 'registered',
-    // 管理员介入管控
+    // Frozen by admin intervention
     FROZEN: 'frozen',
-    // 用户注销，数据软删除，用户数据将不可复用
+    // Soft-deleted user data that must not be reused
     DELETED: 'deleted',
 };
 const SubscriptionStatus = {
-    // 初始状态或注销后状态
+    // Initial or post-cancellation state
     INCOMPLETE: 'incomplete',
-    // 订阅试用期
+    // Trial subscription period
     TRIALING: 'trialing',
-    // 有效订阅激活
+    // Active subscription
     ACTIVE: 'active',
-    // 订阅过期
+    // Past-due subscription
     PAST_DUE: 'past_due',
-    // 取消订阅
+    // Canceled subscription
     CANCELED: 'canceled',
 };
 const OrderStatus = {
-    // 初始状态
+    // Initial state
     CREATED: 'created',
-    // 中间状态，待支付，可能是支付失败事件触发
+    // Intermediate state, awaiting payment; may be triggered by a payment failure event
     PENDING_UNPAID: 'pending_unpaid',
-    // 中间状态(也可是最终状态)，支付成功，后续可变为「退款或取消」
+    // Intermediate or final state; payment succeeded and may later become refunded or canceled
     SUCCESS: 'success',
-    // 中间状态(也可是最终状态)，CheckOut失败或者是支付失败，后续可变为「退款或取消」
+    // Intermediate or final state; checkout or payment failed and may later become refunded or canceled
     FAILED: 'failed',
-    // 最终状态，已退款
+    // Final state, refunded
     REFUNDED: 'refunded',
-    // 最终状态，已取消
+    // Final state, canceled
     CANCELED: 'canceled',
 };
 const TransactionType = {
-    // 订阅订单
+    // Subscription order
     SUBSCRIPTION: 'subscription',
-    // 即付订单
+    // One-time payment order
     ONE_TIME: 'one_time',
 };
 const CreditType = {
-    // 订阅积分
+    // Subscription credits
     PAID: 'paid',
-    // 即付积分
+    // One-time paid credits
     ONE_TIME_PAID: 'one_time_paid',
-    // 免费积分
+    // Free credits
     FREE: 'free',
 };
 const OperationType = {
-    // 系统奖励积分
+    // System-granted credits
     SYS_GIFT: 'system_gift',
-    // 用户消费积分
+    // User credit consumption
     CONSUME: 'consume',
-    // 用户充值积分
+    // User credit recharge
     RECHARGE: 'recharge',
-    // 管理员介入冻结积分
+    // Admin credit freeze
     FREEZE: 'freeze',
-    // 管理员介入解冻积分
+    // Admin credit unfreeze
     UNFREEZE: 'unfreeze',
-    // 管理员介入赠送积分
+    // Admin credit increase
     ADJUST_INCREASE: 'adjust_increase',
-    // 管理员介入抹去积分
+    // Admin credit decrease
     ADJUST_DECREASE: 'adjust_decrease',
-    // 清理积分，事件触发或者是积分过期触发
+    // Credit purge triggered by an event or expiration
     PURGE: 'purge',
 };
-// 支付厂商类型
+// Payment provider types
 const PaySupplier = {
     STRIPE: 'Stripe',
     APPLE: 'Apple',
     PAYPAL: 'Paypal',
 };
 const BillingReason = {
-    // 首次订阅
+    // Initial subscription
     SUBSCRIPTION_CREATE: 'subscription_create',
-    // 续订
+    // Subscription renewal
     SUBSCRIPTION_CYCLE: 'subscription_cycle',
 };
 const PaymentStatus = {
-    // 已支付
+    // Paid
     PAID: 'paid',
-    // 待支付
+    // Pending payment
     UN_PAID: 'un_paid',
-    // 无需支付
+    // No payment required
     NO_PAYMENT_REQUIRED: 'no_payment_required',
 };
 // Validation Functions

package/dist/services/database/constants.mjs

@@ -1,91 +1,91 @@
 // Database Field Enums
 // Keep in sync with DB CHECK constraints
 const UserStatus = {
-    // 匿名用户
+    // Anonymous user
     ANONYMOUS: 'anonymous',
-    // 注册用户
+    // Registered user
     REGISTERED: 'registered',
-    // 管理员介入管控
+    // Frozen by admin intervention
     FROZEN: 'frozen',
-    // 用户注销，数据软删除，用户数据将不可复用
+    // Soft-deleted user data that must not be reused
     DELETED: 'deleted',
 };
 const SubscriptionStatus = {
-    // 初始状态或注销后状态
+    // Initial or post-cancellation state
     INCOMPLETE: 'incomplete',
-    // 订阅试用期
+    // Trial subscription period
     TRIALING: 'trialing',
-    // 有效订阅激活
+    // Active subscription
     ACTIVE: 'active',
-    // 订阅过期
+    // Past-due subscription
     PAST_DUE: 'past_due',
-    // 取消订阅
+    // Canceled subscription
     CANCELED: 'canceled',
 };
 const OrderStatus = {
-    // 初始状态
+    // Initial state
     CREATED: 'created',
-    // 中间状态，待支付，可能是支付失败事件触发
+    // Intermediate state, awaiting payment; may be triggered by a payment failure event
     PENDING_UNPAID: 'pending_unpaid',
-    // 中间状态(也可是最终状态)，支付成功，后续可变为「退款或取消」
+    // Intermediate or final state; payment succeeded and may later become refunded or canceled
     SUCCESS: 'success',
-    // 中间状态(也可是最终状态)，CheckOut失败或者是支付失败，后续可变为「退款或取消」
+    // Intermediate or final state; checkout or payment failed and may later become refunded or canceled
     FAILED: 'failed',
-    // 最终状态，已退款
+    // Final state, refunded
     REFUNDED: 'refunded',
-    // 最终状态，已取消
+    // Final state, canceled
     CANCELED: 'canceled',
 };
 const TransactionType = {
-    // 订阅订单
+    // Subscription order
     SUBSCRIPTION: 'subscription',
-    // 即付订单
+    // One-time payment order
     ONE_TIME: 'one_time',
 };
 const CreditType = {
-    // 订阅积分
+    // Subscription credits
     PAID: 'paid',
-    // 即付积分
+    // One-time paid credits
     ONE_TIME_PAID: 'one_time_paid',
-    // 免费积分
+    // Free credits
     FREE: 'free',
 };
 const OperationType = {
-    // 系统奖励积分
+    // System-granted credits
     SYS_GIFT: 'system_gift',
-    // 用户消费积分
+    // User credit consumption
     CONSUME: 'consume',
-    // 用户充值积分
+    // User credit recharge
     RECHARGE: 'recharge',
-    // 管理员介入冻结积分
+    // Admin credit freeze
     FREEZE: 'freeze',
-    // 管理员介入解冻积分
+    // Admin credit unfreeze
     UNFREEZE: 'unfreeze',
-    // 管理员介入赠送积分
+    // Admin credit increase
     ADJUST_INCREASE: 'adjust_increase',
-    // 管理员介入抹去积分
+    // Admin credit decrease
     ADJUST_DECREASE: 'adjust_decrease',
-    // 清理积分，事件触发或者是积分过期触发
+    // Credit purge triggered by an event or expiration
     PURGE: 'purge',
 };
-// 支付厂商类型
+// Payment provider types
 const PaySupplier = {
     STRIPE: 'Stripe',
     APPLE: 'Apple',
     PAYPAL: 'Paypal',
 };
 const BillingReason = {
-    // 首次订阅
+    // Initial subscription
     SUBSCRIPTION_CREATE: 'subscription_create',
-    // 续订
+    // Subscription renewal
     SUBSCRIPTION_CYCLE: 'subscription_cycle',
 };
 const PaymentStatus = {
-    // 已支付
+    // Paid
     PAID: 'paid',
-    // 待支付
+    // Pending payment
     UN_PAID: 'un_paid',
-    // 无需支付
+    // No payment required
     NO_PAYMENT_REQUIRED: 'no_payment_required',
 };
 // Validation Functions

package/dist/services/database/credit.service.js

@@ -208,7 +208,7 @@ class CreditService {
             const normalized = this.normalizeAmounts({ free: init.creditsChange });
             this.ensureNonNegative(normalized, 'initializeCredit');
             const client = prisma.checkAndFallbackWithNonTCClient(tx);
-            // 这里使用upsert语义是为了代码复用，处理匿名初始化和匿名->注册的初始化
+            // Use upsert semantics to share initialization logic for anonymous users and anonymous-to-registered upgrades.
             const credit = yield client.credit.upsert({
                 where: {
                     userId: init.userId
@@ -430,7 +430,7 @@ class CreditService {
                 where: { userId },
                 data: updateData,
             });
-            // 强制留痕，即使是积分变化为0也记录，操作留痕
+            // Always write an audit entry, even when the credit change is zero.
             const usage = yield this.recordCreditAuditLog(client, userId, constants.OperationType.PURGE, normalizedDeduction, { feature: reason, operationReferId });
             return { credit, usage };
         });

package/dist/services/database/credit.service.mjs

@@ -206,7 +206,7 @@ class CreditService {
             const normalized = this.normalizeAmounts({ free: init.creditsChange });
             this.ensureNonNegative(normalized, 'initializeCredit');
             const client = checkAndFallbackWithNonTCClient(tx);
-            // 这里使用upsert语义是为了代码复用，处理匿名初始化和匿名->注册的初始化
+            // Use upsert semantics to share initialization logic for anonymous users and anonymous-to-registered upgrades.
             const credit = yield client.credit.upsert({
                 where: {
                     userId: init.userId
@@ -428,7 +428,7 @@ class CreditService {
                 where: { userId },
                 data: updateData,
             });
-            // 强制留痕，即使是积分变化为0也记录，操作留痕
+            // Always write an audit entry, even when the credit change is zero.
             const usage = yield this.recordCreditAuditLog(client, userId, OperationType.PURGE, normalizedDeduction, { feature: reason, operationReferId });
             return { credit, usage };
         });