@windrun-huaiin/backend-core 14.1.1 → 14.3.0

package/dist/app/api/user/anonymous/init/route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../src/app/api/user/anonymous/init/route.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgoBxD;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,kCAE9C"}
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../src/app/api/user/anonymous/init/route.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA4rBxD;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,kCAE9C"}

package/dist/app/api/user/anonymous/init/route.js

@@ -1,11 +1,12 @@
 '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 user_aggregate_service = require('../../../../../services/aggregate/user.aggregate.service.js');
+var anonymous_aggregate_service = require('../../../../../services/aggregate/anonymous.aggregate.service.js');
 var server = require('@windrun-huaiin/third-ui/fingerprint/server');
 var server$1 = require('@clerk/nextjs/server');
 var server$2 = require('next/server');
 var userContextService = require('../../../../../services/context/user-context-service.js');
+var userContextFinalizer = require('../../../../../services/context/user-context-finalizer.js');
 
 /* eslint-disable @typescript-eslint/no-explicit-any */
 // Fix BigInt serialization issue
@@ -16,7 +17,7 @@ BigInt.prototype.toJSON = function () {
 /** 创建成功响应对象 */
 function createSuccessResponse(params) {
     const response = Object.assign({ success: true, xUser: userContextService.mapUserToXUser(params.entities.user), xCredit: params.entities.credit ? userContextService.mapCreditToXCredit(params.entities.credit) : null, xSubscription: userContextService.mapSubscriptionToXSubscription(params.entities.subscription), isNewUser: params.isNewUser }, params.options);
-    return userContextService.applyUserMockContext(response);
+    return userContextFinalizer.finalizeUserContext(response);
 }
 /** 创建错误响应 */
 function createErrorResponse(message, status = 400) {
@@ -185,6 +186,28 @@ function detectChannelFromPlatform(platform) {
             return null;
     }
 }
+function detectChannelFromUtmMedium(value) {
+    const normalized = value === null || value === void 0 ? void 0 : value.trim().toLowerCase();
+    if (!normalized) {
+        return null;
+    }
+    if (/^(cpc|ppc|paid|paid_search|display|banner|affiliate|email|newsletter|push|sms)$/.test(normalized)) {
+        return 'campaign';
+    }
+    if (/^(social|social_paid|social-organic|social_organic)$/.test(normalized)) {
+        return 'social';
+    }
+    if (/^(organic|seo|search)$/.test(normalized)) {
+        return 'search';
+    }
+    if (/^(referral|partner)$/.test(normalized)) {
+        return 'referral';
+    }
+    if (/^(ai|llm)$/.test(normalized)) {
+        return 'ai';
+    }
+    return 'campaign';
+}
 function parseUserAgent(request) {
     var _a, _b, _c, _d, _e;
     const userAgentHeader = request.headers.get('user-agent');
@@ -311,17 +334,30 @@ function parseFirstTouchHeader(request) {
     }
 }
 function finalizeAttribution(sourceRef) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     const landingHost = normalizeHost(sourceRef.landingHost);
     const refererHost = normalizeHost(sourceRef.refererHost);
     const internal = isInternalReferer(landingHost, refererHost);
+    const hasCampaignMarker = Boolean(sourceRef.utmSource
+        || sourceRef.utmMedium
+        || sourceRef.utmCampaign
+        || sourceRef.utmTerm
+        || sourceRef.utmContent
+        || sourceRef.utmId
+        || sourceRef.ref
+        || sourceRef.gclid
+        || sourceRef.fbclid
+        || sourceRef.msclkid
+        || sourceRef.ttclid
+        || sourceRef.twclid
+        || sourceRef.liFatId);
     if (internal) {
         sourceRef.isInternalReferer = true;
     }
     const utmPlatform = detectPlatform(sourceRef.utmSource) || detectPlatform(sourceRef.ref);
     if (utmPlatform) {
         sourceRef.sourcePlatform = utmPlatform;
-        sourceRef.sourceChannel = (_b = (_a = detectChannelFromPlatform(utmPlatform)) !== null && _a !== void 0 ? _a : sourceRef.sourceChannel) !== null && _b !== void 0 ? _b : 'campaign';
+        sourceRef.sourceChannel = (_c = (_b = (_a = detectChannelFromPlatform(utmPlatform)) !== null && _a !== void 0 ? _a : detectChannelFromUtmMedium(sourceRef.utmMedium)) !== null && _b !== void 0 ? _b : sourceRef.sourceChannel) !== null && _c !== void 0 ? _c : 'campaign';
         sourceRef.sourceType = 'campaign';
         return;
     }
@@ -361,10 +397,16 @@ function finalizeAttribution(sourceRef) {
         sourceRef.sourceType = 'campaign';
         return;
     }
+    if (hasCampaignMarker) {
+        sourceRef.sourcePlatform = 'other';
+        sourceRef.sourceChannel = (_d = detectChannelFromUtmMedium(sourceRef.utmMedium)) !== null && _d !== void 0 ? _d : 'campaign';
+        sourceRef.sourceType = 'campaign';
+        return;
+    }
     if (!internal && refererHost) {
         const refererPlatform = detectPlatform(refererHost) || detectPlatform(sourceRef.httpRefer);
-        sourceRef.sourcePlatform = (_c = refererPlatform !== null && refererPlatform !== void 0 ? refererPlatform : getRootDomain(refererHost)) !== null && _c !== void 0 ? _c : refererHost;
-        sourceRef.sourceChannel = (_d = detectChannelFromPlatform(refererPlatform)) !== null && _d !== void 0 ? _d : 'referral';
+        sourceRef.sourcePlatform = refererPlatform !== null && refererPlatform !== void 0 ? refererPlatform : 'other';
+        sourceRef.sourceChannel = (_e = detectChannelFromPlatform(refererPlatform)) !== null && _e !== void 0 ? _e : 'referral';
         sourceRef.sourceType = 'referer';
         return;
     }
@@ -486,17 +528,22 @@ function handleFingerprintRequest(request_1) {
                 return createErrorResponse('User not found', 404);
             }
             const sourceRef = extractSourceRef(request);
-            // 创建新的匿名用户
-            const { newUser, credit } = yield user_aggregate_service.userAggregateService.initAnonymousUser(fingerprintId, { sourceRef: sourceRef !== null && sourceRef !== void 0 ? sourceRef : undefined });
-            console.log(`Created new anonymous user ${newUser.userId} with fingerprint ${fingerprintId}`);
+            const anonymousInitResult = yield anonymous_aggregate_service.anonymousAggregateService.getOrCreateByFingerprintId(fingerprintId, { sourceRef: sourceRef !== null && sourceRef !== void 0 ? sourceRef : undefined });
+            if (anonymousInitResult.isNewUser) {
+                console.log(`Created new anonymous user ${anonymousInitResult.user.userId} with fingerprint ${fingerprintId}`);
+            }
             // 返回创建结果
             const response = createSuccessResponse({
                 entities: {
-                    user: newUser,
-                    credit,
-                    subscription: null,
+                    user: anonymousInitResult.user,
+                    credit: anonymousInitResult.credit,
+                    subscription: anonymousInitResult.subscription,
+                },
+                isNewUser: anonymousInitResult.isNewUser,
+                options: {
+                    totalUsersOnDevice: anonymousInitResult.totalUsersOnDevice,
+                    hasAnonymousUser: anonymousInitResult.hasAnonymousUser,
                 },
-                isNewUser: true,
             });
             return server$2.NextResponse.json(response);
         }

package/dist/app/api/user/anonymous/init/route.mjs

@@ -1,9 +1,10 @@
 import { __awaiter, __rest } 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 { userAggregateService } from '../../../../../services/aggregate/user.aggregate.service.mjs';
+import { anonymousAggregateService } from '../../../../../services/aggregate/anonymous.aggregate.service.mjs';
 import { extractFingerprintFromNextRequest } from '@windrun-huaiin/third-ui/fingerprint/server';
 import { auth } from '@clerk/nextjs/server';
 import { NextResponse } from 'next/server';
-import { fetchUserContextByClerkUserId, fetchLatestUserContextByFingerprintId, mapSubscriptionToXSubscription, mapCreditToXCredit, mapUserToXUser, applyUserMockContext } from '../../../../../services/context/user-context-service.mjs';
+import { fetchUserContextByClerkUserId, fetchLatestUserContextByFingerprintId, mapSubscriptionToXSubscription, mapCreditToXCredit, mapUserToXUser } from '../../../../../services/context/user-context-service.mjs';
+import { finalizeUserContext } from '../../../../../services/context/user-context-finalizer.mjs';
 
 /* eslint-disable @typescript-eslint/no-explicit-any */
 // Fix BigInt serialization issue
@@ -14,7 +15,7 @@ BigInt.prototype.toJSON = function () {
 /** 创建成功响应对象 */
 function createSuccessResponse(params) {
     const response = Object.assign({ success: true, xUser: mapUserToXUser(params.entities.user), xCredit: params.entities.credit ? mapCreditToXCredit(params.entities.credit) : null, xSubscription: mapSubscriptionToXSubscription(params.entities.subscription), isNewUser: params.isNewUser }, params.options);
-    return applyUserMockContext(response);
+    return finalizeUserContext(response);
 }
 /** 创建错误响应 */
 function createErrorResponse(message, status = 400) {
@@ -183,6 +184,28 @@ function detectChannelFromPlatform(platform) {
             return null;
     }
 }
+function detectChannelFromUtmMedium(value) {
+    const normalized = value === null || value === void 0 ? void 0 : value.trim().toLowerCase();
+    if (!normalized) {
+        return null;
+    }
+    if (/^(cpc|ppc|paid|paid_search|display|banner|affiliate|email|newsletter|push|sms)$/.test(normalized)) {
+        return 'campaign';
+    }
+    if (/^(social|social_paid|social-organic|social_organic)$/.test(normalized)) {
+        return 'social';
+    }
+    if (/^(organic|seo|search)$/.test(normalized)) {
+        return 'search';
+    }
+    if (/^(referral|partner)$/.test(normalized)) {
+        return 'referral';
+    }
+    if (/^(ai|llm)$/.test(normalized)) {
+        return 'ai';
+    }
+    return 'campaign';
+}
 function parseUserAgent(request) {
     var _a, _b, _c, _d, _e;
     const userAgentHeader = request.headers.get('user-agent');
@@ -309,17 +332,30 @@ function parseFirstTouchHeader(request) {
     }
 }
 function finalizeAttribution(sourceRef) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     const landingHost = normalizeHost(sourceRef.landingHost);
     const refererHost = normalizeHost(sourceRef.refererHost);
     const internal = isInternalReferer(landingHost, refererHost);
+    const hasCampaignMarker = Boolean(sourceRef.utmSource
+        || sourceRef.utmMedium
+        || sourceRef.utmCampaign
+        || sourceRef.utmTerm
+        || sourceRef.utmContent
+        || sourceRef.utmId
+        || sourceRef.ref
+        || sourceRef.gclid
+        || sourceRef.fbclid
+        || sourceRef.msclkid
+        || sourceRef.ttclid
+        || sourceRef.twclid
+        || sourceRef.liFatId);
     if (internal) {
         sourceRef.isInternalReferer = true;
     }
     const utmPlatform = detectPlatform(sourceRef.utmSource) || detectPlatform(sourceRef.ref);
     if (utmPlatform) {
         sourceRef.sourcePlatform = utmPlatform;
-        sourceRef.sourceChannel = (_b = (_a = detectChannelFromPlatform(utmPlatform)) !== null && _a !== void 0 ? _a : sourceRef.sourceChannel) !== null && _b !== void 0 ? _b : 'campaign';
+        sourceRef.sourceChannel = (_c = (_b = (_a = detectChannelFromPlatform(utmPlatform)) !== null && _a !== void 0 ? _a : detectChannelFromUtmMedium(sourceRef.utmMedium)) !== null && _b !== void 0 ? _b : sourceRef.sourceChannel) !== null && _c !== void 0 ? _c : 'campaign';
         sourceRef.sourceType = 'campaign';
         return;
     }
@@ -359,10 +395,16 @@ function finalizeAttribution(sourceRef) {
         sourceRef.sourceType = 'campaign';
         return;
     }
+    if (hasCampaignMarker) {
+        sourceRef.sourcePlatform = 'other';
+        sourceRef.sourceChannel = (_d = detectChannelFromUtmMedium(sourceRef.utmMedium)) !== null && _d !== void 0 ? _d : 'campaign';
+        sourceRef.sourceType = 'campaign';
+        return;
+    }
     if (!internal && refererHost) {
         const refererPlatform = detectPlatform(refererHost) || detectPlatform(sourceRef.httpRefer);
-        sourceRef.sourcePlatform = (_c = refererPlatform !== null && refererPlatform !== void 0 ? refererPlatform : getRootDomain(refererHost)) !== null && _c !== void 0 ? _c : refererHost;
-        sourceRef.sourceChannel = (_d = detectChannelFromPlatform(refererPlatform)) !== null && _d !== void 0 ? _d : 'referral';
+        sourceRef.sourcePlatform = refererPlatform !== null && refererPlatform !== void 0 ? refererPlatform : 'other';
+        sourceRef.sourceChannel = (_e = detectChannelFromPlatform(refererPlatform)) !== null && _e !== void 0 ? _e : 'referral';
         sourceRef.sourceType = 'referer';
         return;
     }
@@ -484,17 +526,22 @@ function handleFingerprintRequest(request_1) {
                 return createErrorResponse('User not found', 404);
             }
             const sourceRef = extractSourceRef(request);
-            // 创建新的匿名用户
-            const { newUser, credit } = yield userAggregateService.initAnonymousUser(fingerprintId, { sourceRef: sourceRef !== null && sourceRef !== void 0 ? sourceRef : undefined });
-            console.log(`Created new anonymous user ${newUser.userId} with fingerprint ${fingerprintId}`);
+            const anonymousInitResult = yield anonymousAggregateService.getOrCreateByFingerprintId(fingerprintId, { sourceRef: sourceRef !== null && sourceRef !== void 0 ? sourceRef : undefined });
+            if (anonymousInitResult.isNewUser) {
+                console.log(`Created new anonymous user ${anonymousInitResult.user.userId} with fingerprint ${fingerprintId}`);
+            }
             // 返回创建结果
             const response = createSuccessResponse({
                 entities: {
-                    user: newUser,
-                    credit,
-                    subscription: null,
+                    user: anonymousInitResult.user,
+                    credit: anonymousInitResult.credit,
+                    subscription: anonymousInitResult.subscription,
+                },
+                isNewUser: anonymousInitResult.isNewUser,
+                options: {
+                    totalUsersOnDevice: anonymousInitResult.totalUsersOnDevice,
+                    hasAnonymousUser: anonymousInitResult.hasAnonymousUser,
                 },
-                isNewUser: true,
             });
             return NextResponse.json(response);
         }

package/dist/index.js

@@ -12,7 +12,9 @@ var apilog_service = require('./services/database/apilog.service.js');
 var constants = require('./services/database/constants.js');
 var user_aggregate_service = require('./services/aggregate/user.aggregate.service.js');
 var billing_aggregate_service = require('./services/aggregate/billing.aggregate.service.js');
+var anonymous_aggregate_service = require('./services/aggregate/anonymous.aggregate.service.js');
 var userContextService = require('./services/context/user-context-service.js');
+var userContextFinalizer = require('./services/context/user-context-finalizer.js');
 var webhookHandler = require('./services/stripe/webhook-handler.js');
 var moneyPriceConfig = require('./lib/money-price-config.js');
 var moneyPriceHelper = require('./lib/money-price-helper.js');
@@ -60,13 +62,14 @@ exports.isValidTransactionType = constants.isValidTransactionType;
 exports.isValidUserStatus = constants.isValidUserStatus;
 exports.userAggregateService = user_aggregate_service.userAggregateService;
 exports.billingAggregateService = billing_aggregate_service.billingAggregateService;
-exports.applyUserMockContext = userContextService.applyUserMockContext;
+exports.anonymousAggregateService = anonymous_aggregate_service.anonymousAggregateService;
 exports.buildInitUserContextFromEntities = userContextService.buildInitUserContextFromEntities;
 exports.fetchLatestUserContextByFingerprintId = userContextService.fetchLatestUserContextByFingerprintId;
 exports.fetchUserContextByClerkUserId = userContextService.fetchUserContextByClerkUserId;
 exports.mapCreditToXCredit = userContextService.mapCreditToXCredit;
 exports.mapSubscriptionToXSubscription = userContextService.mapSubscriptionToXSubscription;
 exports.mapUserToXUser = userContextService.mapUserToXUser;
+exports.finalizeUserContext = userContextFinalizer.finalizeUserContext;
 exports.handleStripeEvent = webhookHandler.handleStripeEvent;
 exports.getActiveProviderConfig = moneyPriceConfig.getActiveProviderConfig;
 exports.getCreditsFromPriceId = moneyPriceConfig.getCreditsFromPriceId;

package/dist/index.mjs

@@ -10,7 +10,9 @@ export { Apilogger, apilogService } from './services/database/apilog.service.mjs
 export { BillingReason, CreditType, OperationType, OrderStatus, PaySupplier, PaymentStatus, SubscriptionStatus, TransactionType, UserStatus, isValidBillingReason, isValidCreditType, isValidOperationType, isValidOrderStatus, isValidPaymentStatus, isValidSubscriptionStatus, isValidTransactionType, isValidUserStatus } from './services/database/constants.mjs';
 export { userAggregateService } from './services/aggregate/user.aggregate.service.mjs';
 export { billingAggregateService } from './services/aggregate/billing.aggregate.service.mjs';
-export { applyUserMockContext, buildInitUserContextFromEntities, fetchLatestUserContextByFingerprintId, fetchUserContextByClerkUserId, mapCreditToXCredit, mapSubscriptionToXSubscription, mapUserToXUser } from './services/context/user-context-service.mjs';
+export { anonymousAggregateService } from './services/aggregate/anonymous.aggregate.service.mjs';
+export { buildInitUserContextFromEntities, fetchLatestUserContextByFingerprintId, fetchUserContextByClerkUserId, mapCreditToXCredit, mapSubscriptionToXSubscription, mapUserToXUser } from './services/context/user-context-service.mjs';
+export { finalizeUserContext } from './services/context/user-context-finalizer.mjs';
 export { handleStripeEvent } from './services/stripe/webhook-handler.mjs';
 export { getActiveProviderConfig, getCreditsFromPriceId, getPriceConfig, moneyPriceConfig } from './lib/money-price-config.mjs';
 export { getMoneyPriceInitUserContext } from './lib/money-price-helper.mjs';

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

@@ -5,6 +5,7 @@ var server = require('@clerk/nextjs/server');
 var headers = require('next/headers');
 var server$1 = require('@windrun-huaiin/third-ui/fingerprint/server');
 var userContextService = require('../services/context/user-context-service.js');
+var userContextFinalizer = require('../services/context/user-context-finalizer.js');
 
 function readFingerprintIdFromRequest() {
     return tslib_es6.__awaiter(this, void 0, void 0, function* () {
@@ -36,7 +37,7 @@ function getMoneyPriceInitUserContext() {
                 subscription: userContext.subscription,
                 isClerkAuthenticated: true,
             });
-            return userContextService.applyUserMockContext(initUserContext);
+            return userContextFinalizer.finalizeUserContext(initUserContext);
         }
         const fingerprintId = yield readFingerprintIdFromRequest();
         if (!fingerprintId) {

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

@@ -2,7 +2,8 @@ import { __awaiter } from '../node_modules/.pnpm/@rollup_plugin-typescript@12.1.
 import { auth } from '@clerk/nextjs/server';
 import { cookies, headers } from 'next/headers';
 import { extractFingerprintFromNextStores } from '@windrun-huaiin/third-ui/fingerprint/server';
-import { fetchUserContextByClerkUserId, buildInitUserContextFromEntities, applyUserMockContext } from '../services/context/user-context-service.mjs';
+import { fetchUserContextByClerkUserId, buildInitUserContextFromEntities } from '../services/context/user-context-service.mjs';
+import { finalizeUserContext } from '../services/context/user-context-finalizer.mjs';
 
 function readFingerprintIdFromRequest() {
     return __awaiter(this, void 0, void 0, function* () {
@@ -34,7 +35,7 @@ function getMoneyPriceInitUserContext() {
                 subscription: userContext.subscription,
                 isClerkAuthenticated: true,
             });
-            return applyUserMockContext(initUserContext);
+            return finalizeUserContext(initUserContext);
         }
         const fingerprintId = yield readFingerprintIdFromRequest();
         if (!fingerprintId) {

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

@@ -0,0 +1,21 @@
+import type { Credit, Subscription, User } from '@/db/prisma-model-type';
+import { Prisma } from '@/db/prisma-model-type';
+type AnonymousInitContext = {
+    user: User;
+    credit: Credit | null;
+    subscription: Subscription | null;
+    isNewUser: boolean;
+    totalUsersOnDevice: number;
+    hasAnonymousUser: boolean;
+};
+declare class AnonymousAggregateService {
+    private lockFingerprintInit;
+    private findLatestUserContextByFingerprintId;
+    private createAnonymousUser;
+    getOrCreateByFingerprintId(fingerprintId: string, options?: {
+        sourceRef?: Prisma.InputJsonValue;
+    }): Promise<AnonymousInitContext>;
+}
+export declare const anonymousAggregateService: AnonymousAggregateService;
+export {};
+//# sourceMappingURL=anonymous.aggregate.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anonymous.aggregate.service.d.ts","sourceRoot":"","sources":["../../../src/services/aggregate/anonymous.aggregate.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAIzE,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAIhD,KAAK,oBAAoB,GAAG;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,cAAM,yBAAyB;YACf,mBAAmB;YAYnB,oCAAoC;YAyBpC,mBAAmB;IAsC3B,0BAA0B,CAC9B,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;KAAE,GAC/C,OAAO,CAAC,oBAAoB,CAAC;CAYjC;AAED,eAAO,MAAM,yBAAyB,2BAAkC,CAAC"}

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

@@ -0,0 +1,87 @@
+'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 user_service = require('../database/user.service.js');
+var subscription_service = require('../database/subscription.service.js');
+var credit_service = require('../database/credit.service.js');
+var client = require('@prisma/client');
+var constants = require('../database/constants.js');
+require('../../prisma/prisma.js');
+var prismaTransactionUtil = require('../../prisma/prisma-transaction-util.js');
+var creditInit = require('../../lib/credit-init.js');
+
+const ANONYMOUS_INIT_LOCK_NAMESPACE = 92831;
+class AnonymousAggregateService {
+    lockFingerprintInit(tx, fingerprintId) {
+        return tslib_es6.__awaiter(this, void 0, void 0, function* () {
+            yield tx.$executeRaw `
+      SELECT pg_advisory_xact_lock(
+        ${client.Prisma.raw(String(ANONYMOUS_INIT_LOCK_NAMESPACE))},
+        hashtext(${fingerprintId})
+      )
+    `;
+        });
+    }
+    findLatestUserContextByFingerprintId(fingerprintId, tx) {
+        return tslib_es6.__awaiter(this, void 0, void 0, function* () {
+            const existingUsers = yield user_service.userService.findListByFingerprintId(fingerprintId, tx);
+            if (existingUsers.length === 0) {
+                return null;
+            }
+            const latestUser = existingUsers[0];
+            const [credit, subscription] = yield Promise.all([
+                credit_service.creditService.getCredit(latestUser.userId, tx),
+                subscription_service.subscriptionService.getActiveSubscription(latestUser.userId, tx),
+            ]);
+            return {
+                user: latestUser,
+                credit,
+                subscription,
+                isNewUser: false,
+                totalUsersOnDevice: existingUsers.length,
+                hasAnonymousUser: true,
+            };
+        });
+    }
+    createAnonymousUser(fingerprintId, tx, options) {
+        return 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 {
+                user: newUser,
+                credit,
+                subscription: null,
+                isNewUser: true,
+                totalUsersOnDevice: 1,
+                hasAnonymousUser: true,
+            };
+        });
+    }
+    getOrCreateByFingerprintId(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* () {
+                yield this.lockFingerprintInit(tx, fingerprintId);
+                const existingContext = yield this.findLatestUserContextByFingerprintId(fingerprintId, tx);
+                if (existingContext) {
+                    return existingContext;
+                }
+                return this.createAnonymousUser(fingerprintId, tx, options);
+            }), 'anonymous_get_or_create_by_fingerprint_id');
+        });
+    }
+}
+const anonymousAggregateService = new AnonymousAggregateService();
+
+exports.anonymousAggregateService = anonymousAggregateService;

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

@@ -0,0 +1,85 @@
+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 { userService } from '../database/user.service.mjs';
+import { subscriptionService } from '../database/subscription.service.mjs';
+import { creditService } from '../database/credit.service.mjs';
+import { Prisma } from '@prisma/client';
+import { UserStatus, OperationType, CreditType } from '../database/constants.mjs';
+import '../../prisma/prisma.mjs';
+import { runInTransaction } from '../../prisma/prisma-transaction-util.mjs';
+import { freeAmount } from '../../lib/credit-init.mjs';
+
+const ANONYMOUS_INIT_LOCK_NAMESPACE = 92831;
+class AnonymousAggregateService {
+    lockFingerprintInit(tx, fingerprintId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield tx.$executeRaw `
+      SELECT pg_advisory_xact_lock(
+        ${Prisma.raw(String(ANONYMOUS_INIT_LOCK_NAMESPACE))},
+        hashtext(${fingerprintId})
+      )
+    `;
+        });
+    }
+    findLatestUserContextByFingerprintId(fingerprintId, tx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const existingUsers = yield userService.findListByFingerprintId(fingerprintId, tx);
+            if (existingUsers.length === 0) {
+                return null;
+            }
+            const latestUser = existingUsers[0];
+            const [credit, subscription] = yield Promise.all([
+                creditService.getCredit(latestUser.userId, tx),
+                subscriptionService.getActiveSubscription(latestUser.userId, tx),
+            ]);
+            return {
+                user: latestUser,
+                credit,
+                subscription,
+                isNewUser: false,
+                totalUsersOnDevice: existingUsers.length,
+                hasAnonymousUser: true,
+            };
+        });
+    }
+    createAnonymousUser(fingerprintId, tx, options) {
+        return __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 {
+                user: newUser,
+                credit,
+                subscription: null,
+                isNewUser: true,
+                totalUsersOnDevice: 1,
+                hasAnonymousUser: true,
+            };
+        });
+    }
+    getOrCreateByFingerprintId(fingerprintId, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return runInTransaction((tx) => __awaiter(this, void 0, void 0, function* () {
+                yield this.lockFingerprintInit(tx, fingerprintId);
+                const existingContext = yield this.findLatestUserContextByFingerprintId(fingerprintId, tx);
+                if (existingContext) {
+                    return existingContext;
+                }
+                return this.createAnonymousUser(fingerprintId, tx, options);
+            }), 'anonymous_get_or_create_by_fingerprint_id');
+        });
+    }
+}
+const anonymousAggregateService = new AnonymousAggregateService();
+
+export { anonymousAggregateService };

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

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

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

@@ -1 +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"}
+{"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;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/services/aggregate/index.js

@@ -2,8 +2,10 @@
 
 var user_aggregate_service = require('./user.aggregate.service.js');
 var billing_aggregate_service = require('./billing.aggregate.service.js');
+var anonymous_aggregate_service = require('./anonymous.aggregate.service.js');
 
 
 
 exports.userAggregateService = user_aggregate_service.userAggregateService;
 exports.billingAggregateService = billing_aggregate_service.billingAggregateService;
+exports.anonymousAggregateService = anonymous_aggregate_service.anonymousAggregateService;

package/dist/services/aggregate/index.mjs

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

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

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

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

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

package/dist/services/context/index.js

@@ -1,13 +1,14 @@
 'use strict';
 
 var userContextService = require('./user-context-service.js');
+var userContextFinalizer = require('./user-context-finalizer.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;
+exports.finalizeUserContext = userContextFinalizer.finalizeUserContext;

package/dist/services/context/index.mjs

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

package/dist/services/context/user-context-finalizer.d.ts

@@ -0,0 +1,13 @@
+import type { XSubscription, XUser } from '@windrun-huaiin/third-ui/fingerprint';
+type FinalizableUserContext = {
+    xUser: XUser | null;
+    xSubscription: XSubscription | null;
+};
+/**
+ * Output finalizer for user-context payloads.
+ * Real data assembly should stay in user-context-service; any optional test-only
+ * shaping is isolated here so production services do not depend on mock code.
+ */
+export declare function finalizeUserContext<T extends FinalizableUserContext>(context: T): T;
+export {};
+//# sourceMappingURL=user-context-finalizer.d.ts.map

package/dist/services/context/user-context-finalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-context-finalizer.d.ts","sourceRoot":"","sources":["../../../src/services/context/user-context-finalizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,sCAAsC,CAAC;AAEjF,KAAK,sBAAsB,GAAG;IAC5B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,sBAAsB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAsEnF"}