@windrun-huaiin/backend-core 30.0.0 → 31.0.1

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

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

@@ -16,7 +16,7 @@ class TransactionService {
                     orderId: data.orderId,
                     orderStatus: data.orderStatus || constants.OrderStatus.CREATED,
                     paymentStatus: data.paymentStatus || constants.PaymentStatus.UN_PAID,
-                    orderExpiredAt: data.orderExpiredAt || new Date(Date.now() + 30 * 60 * 1000), // 默认30分钟过期
+                    orderExpiredAt: data.orderExpiredAt || new Date(Date.now() + 30 * 60 * 1000), // Default expiration: 30 minutes
                     paySupplier: data.paySupplier,
                     payTransactionId: data.payTransactionId,
                     paySubscriptionId: data.paySubscriptionId,

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

@@ -14,7 +14,7 @@ class TransactionService {
                     orderId: data.orderId,
                     orderStatus: data.orderStatus || OrderStatus.CREATED,
                     paymentStatus: data.paymentStatus || PaymentStatus.UN_PAID,
-                    orderExpiredAt: data.orderExpiredAt || new Date(Date.now() + 30 * 60 * 1000), // 默认30分钟过期
+                    orderExpiredAt: data.orderExpiredAt || new Date(Date.now() + 30 * 60 * 1000), // Default expiration: 30 minutes
                     paySupplier: data.paySupplier,
                     payTransactionId: data.payTransactionId,
                     paySubscriptionId: data.paySubscriptionId,

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

@@ -63,7 +63,7 @@ class UserService {
     findByClerkUserId(clerkUserId, tx) {
         return tslib.__awaiter(this, void 0, void 0, function* () {
             const client = prisma.checkAndFallbackWithNonTCClient(tx);
-            // DB的部分索引与这里的状态查询相对应，因而可以使用findUnique
+            // Partial DB indexes match this status filter, so findUnique is valid here.
             return yield client.user.findUnique({
                 where: {
                     clerkUserId,
@@ -137,7 +137,7 @@ class UserService {
             return { users, total };
         });
     }
-    // 批量创建匿名用户
+    // Create anonymous users in bulk
     createBatchAnonymousUsers(fingerprintIds, tx) {
         return tslib.__awaiter(this, void 0, void 0, function* () {
             const client = prisma.checkAndFallbackWithNonTCClient(tx);

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

@@ -61,7 +61,7 @@ class UserService {
     findByClerkUserId(clerkUserId, tx) {
         return __awaiter(this, void 0, void 0, function* () {
             const client = checkAndFallbackWithNonTCClient(tx);
-            // DB的部分索引与这里的状态查询相对应，因而可以使用findUnique
+            // Partial DB indexes match this status filter, so findUnique is valid here.
             return yield client.user.findUnique({
                 where: {
                     clerkUserId,
@@ -135,7 +135,7 @@ class UserService {
             return { users, total };
         });
     }
-    // 批量创建匿名用户
+    // Create anonymous users in bulk
     createBatchAnonymousUsers(fingerprintIds, tx) {
         return __awaiter(this, void 0, void 0, function* () {
             const client = checkAndFallbackWithNonTCClient(tx);

package/dist/services/stripe/webhook-handler.js

@@ -236,7 +236,7 @@ function handleInvoicePaid(invoice) {
             periodEnd: utils.viewLocalTime(subPeriodEnd),
         });
         if (isInitialPayment) {
-            // 首次订阅校验
+            // check
             const nonActiveSubscription = yield subscription_service.subscriptionService.getNonActiveSubscription(userId);
             if (!nonActiveSubscription) {
                 throw new Error(`Subscription status is ACTIVE for user ${userId}, forbidden to re-active!`);
@@ -263,7 +263,7 @@ function handleInvoicePaid(invoice) {
             return;
         }
         if (isRenewal) {
-            // 续订时，一定要查到订阅记录
+            // must query it's subscription db record
             const subscription = yield subscription_service.subscriptionService.findByPaySubscriptionId(subscriptionId);
             if (!subscription) {
                 throw new Error(`Subscription not found for renewal: ${subscriptionId}`);
@@ -274,8 +274,8 @@ function handleInvoicePaid(invoice) {
                 throw new Error(`Renewal invoice ${invoice.id} already processed as ${existingOrder.orderId}, skipping.`);
             }
             // Get credits from current price configuration (handles plan upgrades/downgrades)
-            // 优先从配置中取，取不到就以上个周期的为准作为Fallback，后续有问题再人工补偿，优先保证能用
-            // 只要配置正确，这里就不会出错！
+            // Prefer values from configuration; fall back to the previous cycle value if unavailable. Manual remediation will be applied later if issues occur, prioritizing functional availability
+            // No error occurs here as long as the configuration is correct!
             const creditsForRenewal = subscription.priceId
                 ? moneyPriceConfig.getCreditsFromPriceId(subscription.priceId)
                 : subscription.creditsAllocated;
@@ -386,7 +386,7 @@ function handleInvoicePaymentFailed(invoice) {
         }
         const subscriptionId = parentDetails.subscription;
         const subscriptionMetadata = parentDetails.metadata || {};
-        // 支付ID
+        // PaymentIntentId
         const paymentIntentId = yield stripeConfig.fetchPaymentId(invoice.id);
         console.log('Invoice payment failed event key-info:', {
             invoiceId: invoice.id,

package/dist/services/stripe/webhook-handler.mjs

@@ -234,7 +234,7 @@ function handleInvoicePaid(invoice) {
             periodEnd: viewLocalTime(subPeriodEnd),
         });
         if (isInitialPayment) {
-            // 首次订阅校验
+            // check
             const nonActiveSubscription = yield subscriptionService.getNonActiveSubscription(userId);
             if (!nonActiveSubscription) {
                 throw new Error(`Subscription status is ACTIVE for user ${userId}, forbidden to re-active!`);
@@ -261,7 +261,7 @@ function handleInvoicePaid(invoice) {
             return;
         }
         if (isRenewal) {
-            // 续订时，一定要查到订阅记录
+            // must query it's subscription db record
             const subscription = yield subscriptionService.findByPaySubscriptionId(subscriptionId);
             if (!subscription) {
                 throw new Error(`Subscription not found for renewal: ${subscriptionId}`);
@@ -272,8 +272,8 @@ function handleInvoicePaid(invoice) {
                 throw new Error(`Renewal invoice ${invoice.id} already processed as ${existingOrder.orderId}, skipping.`);
             }
             // Get credits from current price configuration (handles plan upgrades/downgrades)
-            // 优先从配置中取，取不到就以上个周期的为准作为Fallback，后续有问题再人工补偿，优先保证能用
-            // 只要配置正确，这里就不会出错！
+            // Prefer values from configuration; fall back to the previous cycle value if unavailable. Manual remediation will be applied later if issues occur, prioritizing functional availability
+            // No error occurs here as long as the configuration is correct!
             const creditsForRenewal = subscription.priceId
                 ? getCreditsFromPriceId(subscription.priceId)
                 : subscription.creditsAllocated;
@@ -384,7 +384,7 @@ function handleInvoicePaymentFailed(invoice) {
         }
         const subscriptionId = parentDetails.subscription;
         const subscriptionMetadata = parentDetails.metadata || {};
-        // 支付ID
+        // PaymentIntentId
         const paymentIntentId = yield fetchPaymentId(invoice.id);
         console.log('Invoice payment failed event key-info:', {
             invoiceId: invoice.id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/backend-core",
-  "version": "30.0.0",
+  "version": "31.0.1",
   "description": "Shared backend primitives: Prisma schema/client, database services, routing helpers",
   "type": "module",
   "main": "./dist/index.js",
@@ -107,6 +107,11 @@
       "import": "./dist/app/api/user/anonymous/init/route.mjs",
       "require": "./dist/app/api/user/anonymous/init/route.js"
     },
+    "./app/api/user/anonymous/init/fingerprint-only-route": {
+      "types": "./dist/app/api/user/anonymous/init/fingerprint-only-route.d.ts",
+      "import": "./dist/app/api/user/anonymous/init/fingerprint-only-route.mjs",
+      "require": "./dist/app/api/user/anonymous/init/fingerprint-only-route.js"
+    },
     "./app/api/user/credit-overview/route": {
       "types": "./dist/app/api/user/credit-overview/route.d.ts",
       "import": "./dist/app/api/user/credit-overview/route.mjs",
@@ -139,7 +144,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@clerk/nextjs": "^7.0.5",
+    "@clerk/nextjs": "^7.3.3",
     "@upstash/redis": "^1.34.0",
     "@upstash/qstash": "^2.7.0",
     "@upstash/lock": "^0.2.1",
@@ -148,9 +153,9 @@
     "svix": "^1.86.0",
     "tslib": "^2.8.1",
     "zod": "^4.3.6",
-    "@windrun-huaiin/contracts": "^30.0.0",
-    "@windrun-huaiin/third-ui": "^30.0.0",
-    "@windrun-huaiin/lib": "^30.0.0"
+    "@windrun-huaiin/lib": "^31.0.2",
+    "@windrun-huaiin/contracts": "^31.0.0",
+    "@windrun-huaiin/third-ui": "^31.3.1"
   },
   "devDependencies": {
     "@rollup/plugin-alias": "^5.1.1",
@@ -163,7 +168,7 @@
   },
   "peerDependencies": {
     "@windrun-huaiin/contracts": ">=22.0.0",
-    "@clerk/nextjs": "^7.0.5",
+    "@clerk/nextjs": "^7.3.3",
     "@prisma/client": "^7.8.0",
     "next": "16.1.6",
     "stripe": "22.0.2",
@@ -172,6 +177,13 @@
   "publishConfig": {
     "access": "public"
   },
+  "author": "windrun-huaiin",
+  "homepage": "https://d8ger.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/caofanCPU/next-ai-build.git",
+    "directory": "packages/backend-core"
+  },
   "scripts": {
     "build": "rm -rf dist && rollup -c rollup.config.mjs",
     "build:prod": "rm -rf dist && rollup -c rollup.config.mjs",

package/src/app/api/user/anonymous/init/fingerprint-only-route.ts

@@ -0,0 +1,14 @@
+import { handleFingerprintRequest } from './route-shared';
+import type { NextRequest } from 'next/server';
+
+/**
+ * Fingerprint-only anonymous user initialization API.
+ * Use this route in apps that do not install or configure Clerk.
+ * POST /api/user/anonymous/init
+ */
+export async function POST(request: NextRequest) {
+  return handleFingerprintRequest(request, {
+    createIfNotExists: true,
+    getAuthIdentity: async () => null,
+  });
+}