@windrun-huaiin/backend-core 10.0.1

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

@@ -0,0 +1,306 @@
+import { __awaiter } from '../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.mjs';
+import { SubscriptionStatus, PaymentStatus, OrderStatus, TransactionType, PaySupplier, OperationType, CreditType } from '../database/constants.mjs';
+import '../../prisma/prisma.mjs';
+import { runInTransaction } from '../../prisma/prisma-transaction-util.mjs';
+import { subscriptionService } from '../database/subscription.service.mjs';
+import { creditService } from '../database/credit.service.mjs';
+import { transactionService } from '../database/transaction.service.mjs';
+import '@prisma/client';
+
+class BillingAggregateService {
+    recordSubscriptionInitPayment(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c, _d, _e, _f, _g, _h;
+                const now = new Date();
+                // 订阅截止时间统一为到期日最后1s
+                const originSubPeriodEnd = context.periodEnd;
+                const specialEnd = originSubPeriodEnd ? new Date(originSubPeriodEnd.setHours(23, 59, 59, 999)) : originSubPeriodEnd;
+                const updatedSubscription = yield subscriptionService.updateSubscription(context.subIdKey, {
+                    status: SubscriptionStatus.ACTIVE,
+                    orderId: (_a = context.orderId) !== null && _a !== void 0 ? _a : undefined,
+                    paySubscriptionId: context.paySubscriptionId,
+                    priceId: (_b = context.priceId) !== null && _b !== void 0 ? _b : undefined,
+                    priceName: (_c = context.priceName) !== null && _c !== void 0 ? _c : undefined,
+                    creditsAllocated: context.creditsGranted || 0,
+                    subPeriodStart: context.periodStart,
+                    subPeriodEnd: specialEnd,
+                    updatedAt: now,
+                }, tx);
+                yield transactionService.update(context.orderId, {
+                    orderStatus: OrderStatus.SUCCESS,
+                    paymentStatus: PaymentStatus.PAID,
+                    paySubscriptionId: context.paySubscriptionId,
+                    subPeriodStart: context.periodStart,
+                    subPeriodEnd: context.periodEnd,
+                    payInvoiceId: context.invoiceId,
+                    hostedInvoiceUrl: (_d = context.hostedInvoiceUrl) !== null && _d !== void 0 ? _d : undefined,
+                    invoicePdf: (_e = context.invoicePdf) !== null && _e !== void 0 ? _e : undefined,
+                    billingReason: (_f = context.billingReason) !== null && _f !== void 0 ? _f : undefined,
+                    payTransactionId: (_g = context.paymentIntentId) !== null && _g !== void 0 ? _g : undefined,
+                    paidEmail: (_h = context.paidEmail) !== null && _h !== void 0 ? _h : undefined,
+                    paidAt: context.paidAt,
+                    payUpdatedAt: now,
+                }, tx);
+                if (context.creditsGranted > 0) {
+                    yield creditService.rechargeCredit(context.userId, { paid: context.creditsGranted }, {
+                        feature: TransactionType.SUBSCRIPTION,
+                        operationReferId: context.orderId,
+                    }, tx);
+                }
+                yield tx.credit.update({
+                    where: { userId: context.userId },
+                    data: {
+                        paidStart: context.periodStart,
+                        paidEnd: context.periodEnd,
+                    },
+                });
+                return updatedSubscription;
+            }));
+        });
+    }
+    completeOneTimeCheckout(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                var _a;
+                const now = new Date();
+                yield transactionService.update(params.orderId, {
+                    orderStatus: OrderStatus.SUCCESS,
+                    paymentStatus: params.paymentStatus,
+                    payTransactionId: params.payTransactionId,
+                    paidAt: now,
+                    paidEmail: (_a = params.paidEmail) !== null && _a !== void 0 ? _a : undefined,
+                    payUpdatedAt: now,
+                }, tx);
+                if (params.creditsGranted > 0) {
+                    yield creditService.rechargeCredit(params.userId, { oneTimePaid: params.creditsGranted }, {
+                        feature: TransactionType.ONE_TIME,
+                        operationReferId: params.orderId,
+                    }, tx);
+                }
+                yield tx.credit.update({
+                    where: { userId: params.userId },
+                    data: {
+                        oneTimePaidStart: params.oneTimePaidStart,
+                        oneTimePaidEnd: params.oneTimePaidEnd,
+                    },
+                });
+            }));
+        });
+    }
+    recordInitialInvoiceDetails(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                yield transactionService.update(params.orderId, {
+                    payInvoiceId: params.invoiceId,
+                    payTransactionId: params.paymentIntentId,
+                    hostedInvoiceUrl: (_a = params.hostedInvoiceUrl) !== null && _a !== void 0 ? _a : undefined,
+                    invoicePdf: (_b = params.invoicePdf) !== null && _b !== void 0 ? _b : undefined,
+                    billingReason: (_c = params.billingReason) !== null && _c !== void 0 ? _c : undefined,
+                    payUpdatedAt: new Date(),
+                }, tx);
+            }));
+        });
+    }
+    recordSubscriptionRenewalPayment(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+                yield transactionService.createTransaction({
+                    userId: context.userId,
+                    orderId: context.orderId,
+                    orderStatus: OrderStatus.SUCCESS,
+                    paymentStatus: PaymentStatus.PAID,
+                    paySupplier: PaySupplier.STRIPE,
+                    paySubscriptionId: (_a = context.paySubscriptionId) !== null && _a !== void 0 ? _a : undefined,
+                    subPeriodStart: (_b = context.periodStart) !== null && _b !== void 0 ? _b : undefined,
+                    subPeriodEnd: (_c = context.periodEnd) !== null && _c !== void 0 ? _c : undefined,
+                    payInvoiceId: context.invoiceId,
+                    hostedInvoiceUrl: (_d = context.hostedInvoiceUrl) !== null && _d !== void 0 ? _d : undefined,
+                    invoicePdf: (_e = context.invoicePdf) !== null && _e !== void 0 ? _e : undefined,
+                    billingReason: (_f = context.billingReason) !== null && _f !== void 0 ? _f : undefined,
+                    payTransactionId: (_g = context.paymentIntentId) !== null && _g !== void 0 ? _g : undefined,
+                    priceId: (_h = context.priceId) !== null && _h !== void 0 ? _h : undefined,
+                    priceName: (_j = context.priceName) !== null && _j !== void 0 ? _j : undefined,
+                    type: TransactionType.SUBSCRIPTION,
+                    amount: context.amountPaidCents / 100,
+                    currency: context.currency.toUpperCase(),
+                    creditsGranted: context.creditsGranted,
+                    paidAt: (_k = context.paidAt) !== null && _k !== void 0 ? _k : undefined,
+                    paidEmail: context.paidEmail,
+                    payUpdatedAt: new Date(),
+                }, tx);
+                // 订阅截止时间统一为到期日最后1s
+                const originSubPeriodEnd = context.periodEnd;
+                const specialEnd = originSubPeriodEnd ? new Date(originSubPeriodEnd.setHours(23, 59, 59, 999)) : originSubPeriodEnd;
+                yield subscriptionService.updateSubscription(context.subIdKey, {
+                    status: SubscriptionStatus.ACTIVE,
+                    orderId: context.orderId,
+                    subPeriodStart: context.periodStart,
+                    subPeriodEnd: specialEnd,
+                    updatedAt: new Date(),
+                }, tx);
+                if (context.creditsGranted > 0) {
+                    yield creditService.rechargeCredit(context.userId, { paid: context.creditsGranted }, {
+                        feature: `${TransactionType.SUBSCRIPTION}_renewal`,
+                        operationReferId: context.orderId,
+                    }, tx);
+                }
+                yield tx.credit.update({
+                    where: { userId: context.userId },
+                    data: {
+                        paidStart: context.periodStart,
+                        paidEnd: context.periodEnd,
+                    },
+                });
+            }));
+        });
+    }
+    recordInitialPaymentFailure(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
+                yield transactionService.updateStatus(params.orderId, OrderStatus.FAILED, {
+                    paymentStatus: PaymentStatus.UN_PAID,
+                    payInvoiceId: params.invoiceId,
+                    payTransactionId: params.paymentIntentId,
+                    payUpdatedAt: new Date(),
+                    paidDetail: (_a = params.detail) !== null && _a !== void 0 ? _a : undefined,
+                    orderDetail: (_b = params.detail) !== null && _b !== void 0 ? _b : undefined,
+                }, tx);
+            }));
+        });
+    }
+    recordRenewalPaymentFailure(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c, _d, _e, _f;
+                yield transactionService.createTransaction({
+                    userId: context.userId,
+                    orderId: context.orderId,
+                    orderStatus: OrderStatus.FAILED,
+                    paymentStatus: PaymentStatus.UN_PAID,
+                    paySupplier: PaySupplier.STRIPE,
+                    paySubscriptionId: (_a = context.paySubscriptionId) !== null && _a !== void 0 ? _a : undefined,
+                    payInvoiceId: context.invoiceId,
+                    billingReason: (_b = context.billingReason) !== null && _b !== void 0 ? _b : undefined,
+                    payTransactionId: (_c = context.paymentIntentId) !== null && _c !== void 0 ? _c : undefined,
+                    priceId: (_d = context.priceId) !== null && _d !== void 0 ? _d : undefined,
+                    priceName: (_e = context.priceName) !== null && _e !== void 0 ? _e : undefined,
+                    type: TransactionType.SUBSCRIPTION,
+                    amount: context.amountPaidCents / 100,
+                    currency: context.currency.toUpperCase(),
+                    creditsGranted: 0,
+                    paidAt: (_f = context.paidAt) !== null && _f !== void 0 ? _f : undefined,
+                    paidEmail: context.paidEmail,
+                    payUpdatedAt: new Date(),
+                    orderDetail: 'Subscription renewal payment failed',
+                }, tx);
+                yield creditService.payFailedWatcher({
+                    userId: context.userId,
+                    feature: `${TransactionType.SUBSCRIPTION}_renewal_failed`,
+                    operationReferId: context.orderId,
+                    creditType: CreditType.PAID,
+                    operationType: OperationType.RECHARGE,
+                    creditsChange: 0,
+                }, tx);
+                yield subscriptionService.updateSubscription(context.subIdKey, {
+                    status: SubscriptionStatus.PAST_DUE,
+                    orderId: context.orderId,
+                    updatedAt: new Date(),
+                }, tx);
+            }));
+        });
+    }
+    syncSubscriptionFromStripe(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                if (params.isUserCancel) {
+                    // 记录用户取消订阅的时间信息
+                    yield transactionService.update(params.orderId, {
+                        subLastTryCancelAt: new Date(),
+                    }, tx);
+                }
+                yield subscriptionService.updateSubscription(params.subscription.id, {
+                    status: params.status,
+                    subPeriodStart: params.periodStart,
+                    subPeriodEnd: params.periodEnd,
+                    updatedAt: new Date(),
+                }, tx);
+            }));
+        });
+    }
+    processSubscriptionCancel(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                var _a;
+                // 更新订单, 记录取消信息
+                yield transactionService.update(context.orderId, {
+                    subPeriodCanceledAt: context.canceledAt,
+                    subCancellationDetail: (_a = context.cancellationDetail) !== null && _a !== void 0 ? _a : undefined
+                }, tx);
+                // 更新订阅信息
+                yield subscriptionService.updateStatus(context.subIdKey, SubscriptionStatus.CANCELED, tx);
+                // 清理积分并留痕
+                yield creditService.purgePaidCredit(context.userId, 'cancel_subscription_purge', context.orderId, tx);
+            }));
+        });
+    }
+    processSubscriptionRefund(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
+                const now = new Date();
+                yield transactionService.update(context.transaction.orderId, {
+                    orderStatus: OrderStatus.REFUNDED,
+                    paymentStatus: PaymentStatus.UN_PAID,
+                    payUpdatedAt: now,
+                }, tx);
+                const subscription = (_a = context.subscription) !== null && _a !== void 0 ? _a : (context.transaction.paySubscriptionId
+                    ? yield subscriptionService.findByPaySubscriptionId(context.transaction.paySubscriptionId, tx)
+                    : null);
+                if (subscription) {
+                    yield subscriptionService.updateSubscription(subscription.id, {
+                        status: SubscriptionStatus.CANCELED,
+                        updatedAt: now,
+                    }, tx);
+                }
+                const credit = yield creditService.getCredit(context.transaction.userId, tx);
+                const paidBalance = Math.max((_b = credit === null || credit === void 0 ? void 0 : credit.balancePaid) !== null && _b !== void 0 ? _b : 0, 0);
+                if (paidBalance > 0) {
+                    yield creditService.consumeCredit(context.transaction.userId, { paid: paidBalance }, {
+                        feature: OrderStatus.REFUNDED,
+                        operationReferId: context.transaction.orderId,
+                    }, tx);
+                }
+            }));
+        });
+    }
+    processOneTimeRefund(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
+                const now = new Date();
+                yield transactionService.update(context.transaction.orderId, {
+                    orderStatus: OrderStatus.REFUNDED,
+                    paymentStatus: PaymentStatus.UN_PAID,
+                    payUpdatedAt: now,
+                }, tx);
+                const credit = yield creditService.getCredit(context.transaction.userId, tx);
+                const currentBalance = Math.max((_a = credit === null || credit === void 0 ? void 0 : credit.balanceOneTimePaid) !== null && _a !== void 0 ? _a : 0, 0);
+                const granted = Math.max((_b = context.transaction.creditsGranted) !== null && _b !== void 0 ? _b : 0, 0);
+                const amountToConsume = Math.min(currentBalance, granted);
+                if (amountToConsume > 0) {
+                    yield creditService.consumeCredit(context.transaction.userId, { oneTimePaid: amountToConsume }, {
+                        feature: OrderStatus.REFUNDED,
+                        operationReferId: context.transaction.orderId,
+                    }, tx);
+                }
+            }));
+        });
+    }
+}
+const billingAggregateService = new BillingAggregateService();
+
+export { billingAggregateService };

package/dist/services/aggregate/index.d.ts

@@ -0,0 +1,3 @@
+export { userAggregateService } from './user.aggregate.service';
+export { billingAggregateService } from './billing.aggregate.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/aggregate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/aggregate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/services/aggregate/index.js

@@ -0,0 +1,9 @@
+'use strict';
+
+var user_aggregate_service = require('./user.aggregate.service.js');
+var billing_aggregate_service = require('./billing.aggregate.service.js');
+
+
+
+exports.userAggregateService = user_aggregate_service.userAggregateService;
+exports.billingAggregateService = billing_aggregate_service.billingAggregateService;

package/dist/services/aggregate/index.mjs

@@ -0,0 +1,2 @@
+export { userAggregateService } from './user.aggregate.service.mjs';
+export { billingAggregateService } from './billing.aggregate.service.mjs';

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

@@ -0,0 +1,34 @@
+import type { Credit, Prisma, User } from '../database/prisma-model-type';
+export declare class UserAggregateService {
+    initAnonymousUser(fingerprintId: string, options?: {
+        sourceRef?: Prisma.InputJsonValue;
+    }): Promise<{
+        newUser: User;
+        credit: Credit;
+    }>;
+    /**
+     * 创建新的注册用户
+     *
+     * 初始化步骤（与 credit 平行）：
+     * 1. 创建 User 记录
+     * 2. 初始化 Credit 记录（免费积分）
+     * 3. 初始化 Subscription 记录（占位符，status=INCOMPLETE）
+     * 4. 记录 CreditUsage（审计）
+     *
+     * 后续当用户通过 Stripe 订阅时：
+     * - session.completed 或 invoice.paid 会 UPDATE subscription 记录
+     * - 不需要 CREATE，只需 UPDATE 确保逻辑一致
+     */
+    createNewRegisteredUser(clerkUserId: string, email?: string, fingerprintId?: string, userName?: string, sourceRef?: Prisma.InputJsonValue): Promise<{
+        newUser: User;
+        credit: Credit;
+    }>;
+    upgradeToRegistered(userId: string, email: string, clerkUserId: string, userName?: string): Promise<{
+        updateUser: User;
+        credit: Credit;
+    }>;
+    handleUserUnregister(clerkUserId: string): Promise<string | null>;
+    private findUserWithRelations;
+}
+export declare const userAggregateService: UserAggregateService;
+//# sourceMappingURL=user.aggregate.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user.aggregate.service.d.ts","sourceRoot":"","sources":["../../../src/services/aggregate/user.aggregate.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAK1E,qBAAa,oBAAoB;IAEzB,iBAAiB,CACrB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;KAAE,GAC/C,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;KAAE,CAAC;IA6B9C;;;;;;;;;;;;OAYG;IACG,uBAAuB,CAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,CAAC,cAAc,GAChC,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;KAAE,CAAC;IA+BxC,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,UAAU,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;KAAE,CAAC;IA+B3C,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAwBzD,qBAAqB;CAcpC;AAED,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

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

@@ -0,0 +1,136 @@
+'use strict';
+
+var tslib_es6 = require('../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.js');
+var constants = require('../database/constants.js');
+var user_service = require('../database/user.service.js');
+var subscription_service = require('../database/subscription.service.js');
+var credit_service = require('../database/credit.service.js');
+require('@prisma/client');
+require('../../prisma/prisma.js');
+var prismaTransactionUtil = require('../../prisma/prisma-transaction-util.js');
+var creditInit = require('../../lib/credit-init.js');
+
+class UserAggregateService {
+    initAnonymousUser(fingerprintId, options) {
+        return tslib_es6.__awaiter(this, void 0, void 0, function* () {
+            return prismaTransactionUtil.runInTransaction((tx) => tslib_es6.__awaiter(this, void 0, void 0, function* () {
+                const newUser = yield user_service.userService.createUser({
+                    fingerprintId,
+                    sourceRef: options === null || options === void 0 ? void 0 : options.sourceRef,
+                    status: constants.UserStatus.ANONYMOUS,
+                }, tx);
+                const credit = yield credit_service.creditService.initializeCreditWithFree({
+                    userId: newUser.userId,
+                    feature: 'anonymous_user_init',
+                    creditType: constants.CreditType.FREE,
+                    operationType: constants.OperationType.SYS_GIFT,
+                    operationReferId: newUser.userId,
+                    creditsChange: creditInit.freeAmount,
+                }, tx);
+                yield subscription_service.subscriptionService.initializeSubscription(newUser.userId, tx);
+                return { newUser, credit };
+            }));
+        });
+    }
+    /**
+     * 创建新的注册用户
+     *
+     * 初始化步骤（与 credit 平行）：
+     * 1. 创建 User 记录
+     * 2. 初始化 Credit 记录（免费积分）
+     * 3. 初始化 Subscription 记录（占位符，status=INCOMPLETE）
+     * 4. 记录 CreditUsage（审计）
+     *
+     * 后续当用户通过 Stripe 订阅时：
+     * - session.completed 或 invoice.paid 会 UPDATE subscription 记录
+     * - 不需要 CREATE，只需 UPDATE 确保逻辑一致
+     */
+    createNewRegisteredUser(clerkUserId, email, fingerprintId, userName, sourceRef) {
+        return tslib_es6.__awaiter(this, void 0, void 0, function* () {
+            return prismaTransactionUtil.runInTransaction((tx) => tslib_es6.__awaiter(this, void 0, void 0, function* () {
+                const newUser = yield user_service.userService.createUser({
+                    clerkUserId,
+                    email,
+                    fingerprintId,
+                    userName,
+                    sourceRef,
+                    status: constants.UserStatus.REGISTERED,
+                }, tx);
+                const credit = yield credit_service.creditService.initializeCreditWithFree({
+                    userId: newUser.userId,
+                    feature: 'user_registration_init',
+                    creditType: constants.CreditType.FREE,
+                    operationType: constants.OperationType.SYS_GIFT,
+                    operationReferId: newUser.userId,
+                    creditsChange: creditInit.freeRegisterAmount,
+                });
+                yield subscription_service.subscriptionService.initializeSubscription(newUser.userId, tx);
+                return { newUser, credit };
+            }));
+        });
+    }
+    // 注意积分审查日志的处理
+    upgradeToRegistered(userId, email, clerkUserId, userName) {
+        return tslib_es6.__awaiter(this, void 0, void 0, function* () {
+            return prismaTransactionUtil.runInTransaction((tx) => tslib_es6.__awaiter(this, void 0, void 0, function* () {
+                const updateUser = yield user_service.userService.upgradeToRegistered(userId, {
+                    email,
+                    clerkUserId,
+                    userName
+                }, tx);
+                // 先清空匿名积分并审计日志留痕
+                yield credit_service.creditService.purgeFreeCredit(userId, 'user_registered_purge', userId, tx);
+                // 再初始化完成注册获得免费积分
+                const credit = yield credit_service.creditService.initializeCreditWithFree({
+                    userId: updateUser.userId,
+                    feature: 'user_registration_init',
+                    creditType: constants.CreditType.FREE,
+                    operationType: constants.OperationType.SYS_GIFT,
+                    operationReferId: userId,
+                    creditsChange: creditInit.freeRegisterAmount,
+                }, tx);
+                return { updateUser: updateUser, credit: credit };
+            }));
+        });
+    }
+    handleUserUnregister(clerkUserId) {
+        return tslib_es6.__awaiter(this, void 0, void 0, function* () {
+            return prismaTransactionUtil.runInTransaction((tx) => tslib_es6.__awaiter(this, void 0, void 0, function* () {
+                // 根据clerkUserId查找用户
+                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，防止反复注册薅羊毛
+                yield user_service.userService.unregister(user.userId);
+                // 清空积分
+                yield credit_service.creditService.purgeCredit(userId, 'soft_delete_user', userId, tx);
+                const subscription = yield subscription_service.subscriptionService.getActiveSubscription(userId, tx);
+                if (subscription) {
+                    // 如果有订阅信息，则要更新
+                    yield subscription_service.subscriptionService.cancelSubscription(subscription.id, true, tx);
+                }
+                return user.userId;
+            }));
+        });
+    }
+    findUserWithRelations(userId, tx) {
+        return tslib_es6.__awaiter(this, void 0, void 0, function* () {
+            return tx.user.findUnique({
+                where: { userId },
+                include: {
+                    credit: true,
+                    subscription: true,
+                    transactions: true,
+                    creditAuditLogs: true,
+                },
+            });
+        });
+    }
+}
+const userAggregateService = new UserAggregateService();
+
+exports.UserAggregateService = UserAggregateService;
+exports.userAggregateService = userAggregateService;

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

@@ -0,0 +1,133 @@
+import { __awaiter } from '../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.mjs';
+import { UserStatus, OperationType, CreditType } from '../database/constants.mjs';
+import { userService } from '../database/user.service.mjs';
+import { subscriptionService } from '../database/subscription.service.mjs';
+import { creditService } from '../database/credit.service.mjs';
+import '@prisma/client';
+import '../../prisma/prisma.mjs';
+import { runInTransaction } from '../../prisma/prisma-transaction-util.mjs';
+import { freeAmount, freeRegisterAmount } from '../../lib/credit-init.mjs';
+
+class UserAggregateService {
+    initAnonymousUser(fingerprintId, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                const newUser = yield userService.createUser({
+                    fingerprintId,
+                    sourceRef: options === null || options === void 0 ? void 0 : options.sourceRef,
+                    status: UserStatus.ANONYMOUS,
+                }, tx);
+                const credit = yield creditService.initializeCreditWithFree({
+                    userId: newUser.userId,
+                    feature: 'anonymous_user_init',
+                    creditType: CreditType.FREE,
+                    operationType: OperationType.SYS_GIFT,
+                    operationReferId: newUser.userId,
+                    creditsChange: freeAmount,
+                }, tx);
+                yield subscriptionService.initializeSubscription(newUser.userId, tx);
+                return { newUser, credit };
+            }));
+        });
+    }
+    /**
+     * 创建新的注册用户
+     *
+     * 初始化步骤（与 credit 平行）：
+     * 1. 创建 User 记录
+     * 2. 初始化 Credit 记录（免费积分）
+     * 3. 初始化 Subscription 记录（占位符，status=INCOMPLETE）
+     * 4. 记录 CreditUsage（审计）
+     *
+     * 后续当用户通过 Stripe 订阅时：
+     * - session.completed 或 invoice.paid 会 UPDATE subscription 记录
+     * - 不需要 CREATE，只需 UPDATE 确保逻辑一致
+     */
+    createNewRegisteredUser(clerkUserId, email, fingerprintId, userName, sourceRef) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                const newUser = yield userService.createUser({
+                    clerkUserId,
+                    email,
+                    fingerprintId,
+                    userName,
+                    sourceRef,
+                    status: UserStatus.REGISTERED,
+                }, tx);
+                const credit = yield creditService.initializeCreditWithFree({
+                    userId: newUser.userId,
+                    feature: 'user_registration_init',
+                    creditType: CreditType.FREE,
+                    operationType: OperationType.SYS_GIFT,
+                    operationReferId: newUser.userId,
+                    creditsChange: freeRegisterAmount,
+                });
+                yield subscriptionService.initializeSubscription(newUser.userId, tx);
+                return { newUser, credit };
+            }));
+        });
+    }
+    // 注意积分审查日志的处理
+    upgradeToRegistered(userId, email, clerkUserId, userName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                const updateUser = yield userService.upgradeToRegistered(userId, {
+                    email,
+                    clerkUserId,
+                    userName
+                }, tx);
+                // 先清空匿名积分并审计日志留痕
+                yield creditService.purgeFreeCredit(userId, 'user_registered_purge', userId, tx);
+                // 再初始化完成注册获得免费积分
+                const credit = yield creditService.initializeCreditWithFree({
+                    userId: updateUser.userId,
+                    feature: 'user_registration_init',
+                    creditType: CreditType.FREE,
+                    operationType: OperationType.SYS_GIFT,
+                    operationReferId: userId,
+                    creditsChange: freeRegisterAmount,
+                }, tx);
+                return { updateUser: updateUser, credit: credit };
+            }));
+        });
+    }
+    handleUserUnregister(clerkUserId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                // 根据clerkUserId查找用户
+                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，防止反复注册薅羊毛
+                yield userService.unregister(user.userId);
+                // 清空积分
+                yield creditService.purgeCredit(userId, 'soft_delete_user', userId, tx);
+                const subscription = yield subscriptionService.getActiveSubscription(userId, tx);
+                if (subscription) {
+                    // 如果有订阅信息，则要更新
+                    yield subscriptionService.cancelSubscription(subscription.id, true, tx);
+                }
+                return user.userId;
+            }));
+        });
+    }
+    findUserWithRelations(userId, tx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return tx.user.findUnique({
+                where: { userId },
+                include: {
+                    credit: true,
+                    subscription: true,
+                    transactions: true,
+                    creditAuditLogs: true,
+                },
+            });
+        });
+    }
+}
+const userAggregateService = new UserAggregateService();
+
+export { UserAggregateService, userAggregateService };

package/dist/services/context/index.d.ts

@@ -0,0 +1,2 @@
+export * from './user-context-service';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/services/context/index.js

@@ -0,0 +1,13 @@
+'use strict';
+
+var userContextService = require('./user-context-service.js');
+
+
+
+exports.applyUserMockContext = userContextService.applyUserMockContext;
+exports.buildInitUserContextFromEntities = userContextService.buildInitUserContextFromEntities;
+exports.fetchLatestUserContextByFingerprintId = userContextService.fetchLatestUserContextByFingerprintId;
+exports.fetchUserContextByClerkUserId = userContextService.fetchUserContextByClerkUserId;
+exports.mapCreditToXCredit = userContextService.mapCreditToXCredit;
+exports.mapSubscriptionToXSubscription = userContextService.mapSubscriptionToXSubscription;
+exports.mapUserToXUser = userContextService.mapUserToXUser;

package/dist/services/context/index.mjs

@@ -0,0 +1 @@
+export { applyUserMockContext, buildInitUserContextFromEntities, fetchLatestUserContextByFingerprintId, fetchUserContextByClerkUserId, mapCreditToXCredit, mapSubscriptionToXSubscription, mapUserToXUser } from './user-context-service.mjs';