@windrun-huaiin/backend-core 14.1.1 → 14.2.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;AA2rBxD;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,kCAE9C"}

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

@@ -1,7 +1,7 @@
 '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');
@@ -185,6 +185,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 +333,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 +396,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 +527,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,5 +1,5 @@
 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';
@@ -183,6 +183,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 +331,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 +394,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 +525,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,6 +12,7 @@ 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 webhookHandler = require('./services/stripe/webhook-handler.js');
 var moneyPriceConfig = require('./lib/money-price-config.js');
@@ -60,6 +61,7 @@ exports.isValidTransactionType = constants.isValidTransactionType;
 exports.isValidUserStatus = constants.isValidUserStatus;
 exports.userAggregateService = user_aggregate_service.userAggregateService;
 exports.billingAggregateService = billing_aggregate_service.billingAggregateService;
+exports.anonymousAggregateService = anonymous_aggregate_service.anonymousAggregateService;
 exports.applyUserMockContext = userContextService.applyUserMockContext;
 exports.buildInitUserContextFromEntities = userContextService.buildInitUserContextFromEntities;
 exports.fetchLatestUserContextByFingerprintId = userContextService.fetchLatestUserContextByFingerprintId;

package/dist/index.mjs

@@ -10,6 +10,7 @@ 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 { anonymousAggregateService } from './services/aggregate/anonymous.aggregate.service.mjs';
 export { applyUserMockContext, buildInitUserContextFromEntities, fetchLatestUserContextByFingerprintId, fetchUserContextByClerkUserId, mapCreditToXCredit, mapSubscriptionToXSubscription, mapUserToXUser } from './services/context/user-context-service.mjs';
 export { handleStripeEvent } from './services/stripe/webhook-handler.mjs';
 export { getActiveProviderConfig, getCreditsFromPriceId, getPriceConfig, moneyPriceConfig } from './lib/money-price-config.mjs';

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/backend-core",
-  "version": "14.1.1",
+  "version": "14.2.0",
   "description": "Shared backend primitives: Prisma schema/client, database services, routing helpers",
   "type": "module",
   "main": "./dist/index.js",
@@ -95,7 +95,7 @@
     "svix": "^1.86.0",
     "zod": "^4.3.6",
     "@windrun-huaiin/lib": "^14.0.0",
-    "@windrun-huaiin/third-ui": "^14.0.2"
+    "@windrun-huaiin/third-ui": "^14.1.0"
   },
   "devDependencies": {
     "@rollup/plugin-alias": "^5.1.1",

package/src/app/api/user/anonymous/init/route.ts

@@ -5,7 +5,7 @@
   return this.toString();
 };
 
-import { userAggregateService } from '@/aggregate/user.aggregate.service';
+import { anonymousAggregateService } from '@/aggregate/anonymous.aggregate.service';
 import type { XCredit, XSubscription, XUser } from '@windrun-huaiin/third-ui/fingerprint';
 import { extractFingerprintFromNextRequest } from '@windrun-huaiin/third-ui/fingerprint/server';
 import { auth } from '@clerk/nextjs/server';
@@ -306,6 +306,35 @@ function detectChannelFromPlatform(platform: string | null | undefined): string
   }
 }
 
+function detectChannelFromUtmMedium(value: string | null | undefined): string | null {
+  const normalized = 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: NextRequest): Pick<SourceRefData, 'userAgent' | 'deviceType' | 'os' | 'browser' | 'secChUaMobile' | 'secChUaPlatform'> {
   const userAgentHeader = request.headers.get('user-agent');
   const secChUaMobile = normalizeQueryParam(request.headers.get('sec-ch-ua-mobile')) ?? undefined;
@@ -430,6 +459,21 @@ function finalizeAttribution(sourceRef: SourceRefData) {
   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;
   }
@@ -437,7 +481,10 @@ function finalizeAttribution(sourceRef: SourceRefData) {
   const utmPlatform = detectPlatform(sourceRef.utmSource) || detectPlatform(sourceRef.ref);
   if (utmPlatform) {
     sourceRef.sourcePlatform = utmPlatform;
-    sourceRef.sourceChannel = detectChannelFromPlatform(utmPlatform) ?? sourceRef.sourceChannel ?? 'campaign';
+    sourceRef.sourceChannel = detectChannelFromPlatform(utmPlatform)
+      ?? detectChannelFromUtmMedium(sourceRef.utmMedium)
+      ?? sourceRef.sourceChannel
+      ?? 'campaign';
     sourceRef.sourceType = 'campaign';
     return;
   }
@@ -484,9 +531,16 @@ function finalizeAttribution(sourceRef: SourceRefData) {
     return;
   }
 
+  if (hasCampaignMarker) {
+    sourceRef.sourcePlatform = 'other';
+    sourceRef.sourceChannel = detectChannelFromUtmMedium(sourceRef.utmMedium) ?? 'campaign';
+    sourceRef.sourceType = 'campaign';
+    return;
+  }
+
   if (!internal && refererHost) {
     const refererPlatform = detectPlatform(refererHost) || detectPlatform(sourceRef.httpRefer);
-    sourceRef.sourcePlatform = refererPlatform ?? getRootDomain(refererHost) ?? refererHost;
+    sourceRef.sourcePlatform = refererPlatform ?? 'other';
     sourceRef.sourceChannel = detectChannelFromPlatform(refererPlatform) ?? 'referral';
     sourceRef.sourceType = 'referer';
     return;
@@ -624,22 +678,27 @@ async function handleFingerprintRequest(request: NextRequest, options: { createI
 
     const sourceRef = extractSourceRef(request);
 
-    // 创建新的匿名用户
-    const { newUser, credit } = await userAggregateService.initAnonymousUser(
+    const anonymousInitResult = await anonymousAggregateService.getOrCreateByFingerprintId(
       fingerprintId,
       { sourceRef: sourceRef??  undefined}
     );
 
-    console.log(`Created new anonymous user ${newUser.userId} with fingerprint ${fingerprintId}`);
+    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/src/services/aggregate/anonymous.aggregate.service.ts

@@ -0,0 +1,113 @@
+import { creditService, subscriptionService, userService } from '@/db';
+import { UserStatus } from '@/db/constants';
+import type { Credit, Subscription, User } from '@/db/prisma-model-type';
+import { freeAmount } from '@/lib/credit-init';
+import { runInTransaction } from '@/prisma/prisma-transaction-util';
+import { CreditType, OperationType } from '@/db/constants';
+import { Prisma } from '@/db/prisma-model-type';
+
+const ANONYMOUS_INIT_LOCK_NAMESPACE = 92831;
+
+type AnonymousInitContext = {
+  user: User;
+  credit: Credit | null;
+  subscription: Subscription | null;
+  isNewUser: boolean;
+  totalUsersOnDevice: number;
+  hasAnonymousUser: boolean;
+};
+
+class AnonymousAggregateService {
+  private async lockFingerprintInit(
+    tx: Prisma.TransactionClient,
+    fingerprintId: string,
+  ): Promise<void> {
+    await tx.$executeRaw`
+      SELECT pg_advisory_xact_lock(
+        ${Prisma.raw(String(ANONYMOUS_INIT_LOCK_NAMESPACE))},
+        hashtext(${fingerprintId})
+      )
+    `;
+  }
+
+  private async findLatestUserContextByFingerprintId(
+    fingerprintId: string,
+    tx: Prisma.TransactionClient,
+  ): Promise<AnonymousInitContext | null> {
+    const existingUsers = await userService.findListByFingerprintId(fingerprintId, tx);
+    if (existingUsers.length === 0) {
+      return null;
+    }
+
+    const latestUser = existingUsers[0];
+    const [credit, subscription] = await Promise.all([
+      creditService.getCredit(latestUser.userId, tx),
+      subscriptionService.getActiveSubscription(latestUser.userId, tx),
+    ]);
+
+    return {
+      user: latestUser,
+      credit,
+      subscription,
+      isNewUser: false,
+      totalUsersOnDevice: existingUsers.length,
+      hasAnonymousUser: true,
+    };
+  }
+
+  private async createAnonymousUser(
+    fingerprintId: string,
+    tx: Prisma.TransactionClient,
+    options?: { sourceRef?: Prisma.InputJsonValue; },
+  ): Promise<AnonymousInitContext> {
+    const newUser = await userService.createUser(
+      {
+        fingerprintId,
+        sourceRef: options?.sourceRef,
+        status: UserStatus.ANONYMOUS,
+      },
+      tx,
+    );
+
+    const credit = await creditService.initializeCreditWithFree(
+      {
+        userId: newUser.userId,
+        feature: 'anonymous_user_init',
+        creditType: CreditType.FREE,
+        operationType: OperationType.SYS_GIFT,
+        operationReferId: newUser.userId,
+        creditsChange: freeAmount,
+      },
+      tx,
+    );
+
+    await subscriptionService.initializeSubscription(newUser.userId, tx);
+
+    return {
+      user: newUser,
+      credit,
+      subscription: null,
+      isNewUser: true,
+      totalUsersOnDevice: 1,
+      hasAnonymousUser: true,
+    };
+  }
+
+  async getOrCreateByFingerprintId(
+    fingerprintId: string,
+    options?: { sourceRef?: Prisma.InputJsonValue; },
+  ): Promise<AnonymousInitContext> {
+    return runInTransaction(async (tx) => {
+      await this.lockFingerprintInit(tx, fingerprintId);
+
+      const existingContext = await this.findLatestUserContextByFingerprintId(fingerprintId, tx);
+      if (existingContext) {
+        return existingContext;
+      }
+
+      return this.createAnonymousUser(fingerprintId, tx, options);
+    }, 'anonymous_get_or_create_by_fingerprint_id');
+  }
+}
+
+export const anonymousAggregateService = new AnonymousAggregateService();

package/src/services/aggregate/index.ts

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