@windrun-huaiin/backend-core 30.0.0 → 31.0.1

package/dist/lib/stripe-config.js

@@ -60,7 +60,7 @@ const createCheckoutSession = (params, subscriptionData) => tslib.__awaiter(void
     }
     // One-time payment specific configuration
     if (isSubscriptionMode) {
-        // 在这里注入订单元数据，以保证后续事件处理能根据订单去匹配处理，只能在订阅模式里设置数据，否则Stripe报错
+        // Attach order metadata for later event matching. Stripe only allows this in subscription mode.
         sessionParams.subscription_data = subscriptionData;
     }
     else {
@@ -89,7 +89,7 @@ const createCheckoutSession = (params, subscriptionData) => tslib.__awaiter(void
         throw error;
     }
 });
-// 根据发票ID去查支付ID
+// Resolve the payment ID from an invoice ID.
 const fetchPaymentId = (invoiceId) => tslib.__awaiter(void 0, void 0, void 0, function* () {
     var _a, _b;
     const fullInvoice = yield getStripe().invoices.retrieve(invoiceId, {
@@ -147,7 +147,7 @@ const createOrGetCustomer = (params) => tslib.__awaiter(void 0, void 0, void 0,
             return stripeCustomer.id;
         }
     }
-    // 创建新客户
+    // Create a new customer.
     const customerParams = {
         metadata: {
             user_id: userId,

package/dist/lib/stripe-config.mjs

@@ -58,7 +58,7 @@ const createCheckoutSession = (params, subscriptionData) => __awaiter(void 0, vo
     }
     // One-time payment specific configuration
     if (isSubscriptionMode) {
-        // 在这里注入订单元数据，以保证后续事件处理能根据订单去匹配处理，只能在订阅模式里设置数据，否则Stripe报错
+        // Attach order metadata for later event matching. Stripe only allows this in subscription mode.
         sessionParams.subscription_data = subscriptionData;
     }
     else {
@@ -87,7 +87,7 @@ const createCheckoutSession = (params, subscriptionData) => __awaiter(void 0, vo
         throw error;
     }
 });
-// 根据发票ID去查支付ID
+// Resolve the payment ID from an invoice ID.
 const fetchPaymentId = (invoiceId) => __awaiter(void 0, void 0, void 0, function* () {
     var _a, _b;
     const fullInvoice = yield getStripe().invoices.retrieve(invoiceId, {
@@ -145,7 +145,7 @@ const createOrGetCustomer = (params) => __awaiter(void 0, void 0, void 0, functi
             return stripeCustomer.id;
         }
     }
-    // 创建新客户
+    // Create a new customer.
     const customerParams = {
         metadata: {
             user_id: userId,

package/dist/prisma/prisma-transaction-util.js

@@ -3,7 +3,7 @@
 var tslib = require('tslib');
 var prisma = require('./prisma.js');
 
-// 事务工具类，回滚时打印回滚日志
+// Transaction helper that logs rollback details on failure.
 function runInTransaction(fn, operationName) {
     return tslib.__awaiter(this, void 0, void 0, function* () {
         const start = Date.now();

package/dist/prisma/prisma-transaction-util.mjs

@@ -1,7 +1,7 @@
 import { __awaiter } from 'tslib';
 import { getBackendCorePrisma } from './prisma.mjs';
 
-// 事务工具类，回滚时打印回滚日志
+// Transaction helper that logs rollback details on failure.
 function runInTransaction(fn, operationName) {
     return __awaiter(this, void 0, void 0, function* () {
         const start = Date.now();

package/dist/prisma/prisma.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prisma.d.ts","sourceRoot":"","sources":["../../src/prisma/prisma.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,MAAM,MAAM,uBAAuB,GAAG,2BAA2B,CAAC;AAClE,MAAM,MAAM,2BAA2B,GAAG;IAKxC,YAAY,EAAE,GAAG,CAAC;IAElB,GAAG,CAAC,EAAE,GAAG,CAAC;IAEV,WAAW,EAAE,GAAG,CAAC;IAEjB,iBAAiB,CAAC,EAAE,GAAG,CAAC;IAExB,SAAS,EAAE,GAAG,CAAC;IAEf,eAAe,CAAC,EAAE,GAAG,CAAC;IAEtB,IAAI,EAAE,GAAG,CAAC;IAEV,YAAY,EAAE,GAAG,CAAC;IAElB,MAAM,EAAE,GAAG,CAAC;IAEZ,WAAW,EAAE,GAAG,CAAC;IAEjB,cAAc,EAAE,GAAG,CAAC;IAEpB,UAAU,EAAE,GAAG,CAAC;IAEhB,MAAM,EAAE,GAAG,CAAC;CACb,CAAC;AA2CF,wBAAgB,kBAAkB,IAAI,KAAK,CAI1C;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,2BAA2B,EACzC,UAAU,SAAmE,GAC5E,2BAA2B,CAK7B;AAED,wBAAgB,oBAAoB,IAAI,uBAAuB,CAQ9D;AAID,eAAO,MAAM,MAAM,6BAIjB,CAAC;AAuFH,wBAAgB,+BAA+B,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,GAAG,uBAAuB,CAEjI"}
+{"version":3,"file":"prisma.d.ts","sourceRoot":"","sources":["../../src/prisma/prisma.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,MAAM,MAAM,uBAAuB,GAAG,2BAA2B,CAAC;AAClE,MAAM,MAAM,2BAA2B,GAAG;IAKxC,YAAY,EAAE,GAAG,CAAC;IAElB,GAAG,CAAC,EAAE,GAAG,CAAC;IAEV,WAAW,EAAE,GAAG,CAAC;IAEjB,iBAAiB,CAAC,EAAE,GAAG,CAAC;IAExB,SAAS,EAAE,GAAG,CAAC;IAEf,eAAe,CAAC,EAAE,GAAG,CAAC;IAEtB,IAAI,EAAE,GAAG,CAAC;IAEV,YAAY,EAAE,GAAG,CAAC;IAElB,MAAM,EAAE,GAAG,CAAC;IAEZ,WAAW,EAAE,GAAG,CAAC;IAEjB,cAAc,EAAE,GAAG,CAAC;IAEpB,UAAU,EAAE,GAAG,CAAC;IAEhB,MAAM,EAAE,GAAG,CAAC;CACb,CAAC;AA2CF,wBAAgB,kBAAkB,IAAI,KAAK,CAI1C;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,2BAA2B,EACzC,UAAU,SAAmE,GAC5E,2BAA2B,CAK7B;AAED,wBAAgB,oBAAoB,IAAI,uBAAuB,CAQ9D;AAID,eAAO,MAAM,MAAM,6BAIjB,CAAC;AAsFH,wBAAgB,+BAA+B,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,GAAG,uBAAuB,CAEjI"}

package/dist/prisma/prisma.js

@@ -1,7 +1,7 @@
 'use strict';
 
 const globalForPrisma = globalThis;
-// ==================== 日志配置 ====================
+// ==================== Logging Configuration ====================
 const getLogConfig = () => {
     if (process.env.PRISMA_DEBUG === 'true') {
         return [
@@ -67,41 +67,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');
@@ -114,20 +113,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/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;