@windrun-huaiin/backend-core 14.1.1 → 14.3.0

package/dist/services/context/user-context-finalizer.js

@@ -0,0 +1,74 @@
+'use strict';
+
+var utils = require('@windrun-huaiin/lib/utils');
+
+/**
+ * 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.
+ */
+function finalizeUserContext(context) {
+    var _a;
+    const mockEnabled = process.env.MONEY_PRICE_MOCK_USER_ENABLED === 'true';
+    const mockType = Number((_a = process.env.MONEY_PRICE_MOCK_USER_TYPE) !== null && _a !== void 0 ? _a : NaN);
+    if (!context.xUser ||
+        !mockEnabled ||
+        !Number.isInteger(mockType) ||
+        mockType < 0 ||
+        mockType > 4) {
+        return context;
+    }
+    const ensureSubscription = () => {
+        if (!context.xSubscription) {
+            const now = new Date();
+            context.xSubscription = {
+                id: BigInt(99999),
+                userId: context.xUser.userId,
+                paySubscriptionId: 'MOCK-PAY-SUB-ID',
+                orderId: '',
+                priceId: '',
+                priceName: 'MOCK-TEST',
+                status: 'active',
+                creditsAllocated: 0,
+                subPeriodStart: utils.viewLocalTime(now),
+                subPeriodEnd: utils.viewLocalTime(now),
+            };
+        }
+        return context.xSubscription;
+    };
+    switch (mockType) {
+        case 0: {
+            const subscription = ensureSubscription();
+            subscription.status = '';
+            subscription.priceId = '';
+            break;
+        }
+        case 1: {
+            const subscription = ensureSubscription();
+            subscription.priceId =
+                process.env.STRIPE_PRO_MONTHLY_PRICE_ID || subscription.priceId;
+            break;
+        }
+        case 2: {
+            const subscription = ensureSubscription();
+            subscription.priceId =
+                process.env.STRIPE_ULTRA_MONTHLY_PRICE_ID || subscription.priceId;
+            break;
+        }
+        case 3: {
+            const subscription = ensureSubscription();
+            subscription.priceId =
+                process.env.STRIPE_PRO_YEARLY_PRICE_ID || subscription.priceId;
+            break;
+        }
+        case 4: {
+            const subscription = ensureSubscription();
+            subscription.priceId =
+                process.env.STRIPE_ULTRA_YEARLY_PRICE_ID || subscription.priceId;
+            break;
+        }
+    }
+    return context;
+}
+
+exports.finalizeUserContext = finalizeUserContext;

package/dist/services/context/user-context-finalizer.mjs

@@ -0,0 +1,72 @@
+import { viewLocalTime } from '@windrun-huaiin/lib/utils';
+
+/**
+ * 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.
+ */
+function finalizeUserContext(context) {
+    var _a;
+    const mockEnabled = process.env.MONEY_PRICE_MOCK_USER_ENABLED === 'true';
+    const mockType = Number((_a = process.env.MONEY_PRICE_MOCK_USER_TYPE) !== null && _a !== void 0 ? _a : NaN);
+    if (!context.xUser ||
+        !mockEnabled ||
+        !Number.isInteger(mockType) ||
+        mockType < 0 ||
+        mockType > 4) {
+        return context;
+    }
+    const ensureSubscription = () => {
+        if (!context.xSubscription) {
+            const now = new Date();
+            context.xSubscription = {
+                id: BigInt(99999),
+                userId: context.xUser.userId,
+                paySubscriptionId: 'MOCK-PAY-SUB-ID',
+                orderId: '',
+                priceId: '',
+                priceName: 'MOCK-TEST',
+                status: 'active',
+                creditsAllocated: 0,
+                subPeriodStart: viewLocalTime(now),
+                subPeriodEnd: viewLocalTime(now),
+            };
+        }
+        return context.xSubscription;
+    };
+    switch (mockType) {
+        case 0: {
+            const subscription = ensureSubscription();
+            subscription.status = '';
+            subscription.priceId = '';
+            break;
+        }
+        case 1: {
+            const subscription = ensureSubscription();
+            subscription.priceId =
+                process.env.STRIPE_PRO_MONTHLY_PRICE_ID || subscription.priceId;
+            break;
+        }
+        case 2: {
+            const subscription = ensureSubscription();
+            subscription.priceId =
+                process.env.STRIPE_ULTRA_MONTHLY_PRICE_ID || subscription.priceId;
+            break;
+        }
+        case 3: {
+            const subscription = ensureSubscription();
+            subscription.priceId =
+                process.env.STRIPE_PRO_YEARLY_PRICE_ID || subscription.priceId;
+            break;
+        }
+        case 4: {
+            const subscription = ensureSubscription();
+            subscription.priceId =
+                process.env.STRIPE_ULTRA_YEARLY_PRICE_ID || subscription.priceId;
+            break;
+        }
+    }
+    return context;
+}
+
+export { finalizeUserContext };

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

@@ -21,10 +21,4 @@ export declare function buildInitUserContextFromEntities(params: {
 }): InitUserContext;
 export declare function fetchUserContextByClerkUserId(clerkUserId: string): Promise<UserContextEntities | null>;
 export declare function fetchLatestUserContextByFingerprintId(fingerprintId: string): Promise<FingerprintUserContext | null>;
-type MockableContext = {
-    xUser: XUser | null;
-    xSubscription: XSubscription | null;
-};
-export declare function applyUserMockContext<T extends MockableContext>(context: T): T;
-export {};
 //# sourceMappingURL=user-context-service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"user-context-service.d.ts","sourceRoot":"","sources":["../../../src/services/context/user-context-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,CAWhD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAgB1D;AAED,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,YAAY,GAAG,IAAI,GAChC,aAAa,GAAG,IAAI,CAiBtB;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GAAG,eAAe,CAQlB;AAED,wBAAsB,6BAA6B,CACjD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAarC;AAED,wBAAsB,qCAAqC,CACzD,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAmBxC;AAED,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,eAAe,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAsE7E"}
+{"version":3,"file":"user-context-service.d.ts","sourceRoot":"","sources":["../../../src/services/context/user-context-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,CAWhD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAgB1D;AAED,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,YAAY,GAAG,IAAI,GAChC,aAAa,GAAG,IAAI,CAiBtB;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GAAG,eAAe,CAQlB;AAED,wBAAsB,6BAA6B,CACjD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAarC;AAED,wBAAsB,qCAAqC,CACzD,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAmBxC"}

package/dist/services/context/user-context-service.js

@@ -97,71 +97,7 @@ function fetchLatestUserContextByFingerprintId(fingerprintId) {
         };
     });
 }
-function applyUserMockContext(context) {
-    var _a;
-    const mockEnabled = process.env.MONEY_PRICE_MOCK_USER_ENABLED === 'true';
-    const mockType = Number((_a = process.env.MONEY_PRICE_MOCK_USER_TYPE) !== null && _a !== void 0 ? _a : NaN);
-    if (!context.xUser ||
-        !mockEnabled ||
-        !Number.isInteger(mockType) ||
-        mockType < 0 ||
-        mockType > 4) {
-        return context;
-    }
-    const ensureSubscription = () => {
-        if (!context.xSubscription) {
-            const now = new Date();
-            context.xSubscription = {
-                id: BigInt(99999),
-                userId: context.xUser.userId,
-                paySubscriptionId: 'MOCK-PAY-SUB-ID',
-                orderId: '',
-                priceId: '',
-                priceName: 'MOCK-TEST',
-                status: 'active',
-                creditsAllocated: 0,
-                subPeriodStart: utils.viewLocalTime(now),
-                subPeriodEnd: utils.viewLocalTime(now),
-            };
-        }
-        return context.xSubscription;
-    };
-    switch (mockType) {
-        case 0: {
-            const subscription = ensureSubscription();
-            subscription.status = '';
-            subscription.priceId = '';
-            break;
-        }
-        case 1: {
-            const subscription = ensureSubscription();
-            subscription.priceId =
-                process.env.STRIPE_PRO_MONTHLY_PRICE_ID || subscription.priceId;
-            break;
-        }
-        case 2: {
-            const subscription = ensureSubscription();
-            subscription.priceId =
-                process.env.STRIPE_ULTRA_MONTHLY_PRICE_ID || subscription.priceId;
-            break;
-        }
-        case 3: {
-            const subscription = ensureSubscription();
-            subscription.priceId =
-                process.env.STRIPE_PRO_YEARLY_PRICE_ID || subscription.priceId;
-            break;
-        }
-        case 4: {
-            const subscription = ensureSubscription();
-            subscription.priceId =
-                process.env.STRIPE_ULTRA_YEARLY_PRICE_ID || subscription.priceId;
-            break;
-        }
-    }
-    return context;
-}
 
-exports.applyUserMockContext = applyUserMockContext;
 exports.buildInitUserContextFromEntities = buildInitUserContextFromEntities;
 exports.fetchLatestUserContextByFingerprintId = fetchLatestUserContextByFingerprintId;
 exports.fetchUserContextByClerkUserId = fetchUserContextByClerkUserId;

package/dist/services/context/user-context-service.mjs

@@ -95,68 +95,5 @@ function fetchLatestUserContextByFingerprintId(fingerprintId) {
         };
     });
 }
-function applyUserMockContext(context) {
-    var _a;
-    const mockEnabled = process.env.MONEY_PRICE_MOCK_USER_ENABLED === 'true';
-    const mockType = Number((_a = process.env.MONEY_PRICE_MOCK_USER_TYPE) !== null && _a !== void 0 ? _a : NaN);
-    if (!context.xUser ||
-        !mockEnabled ||
-        !Number.isInteger(mockType) ||
-        mockType < 0 ||
-        mockType > 4) {
-        return context;
-    }
-    const ensureSubscription = () => {
-        if (!context.xSubscription) {
-            const now = new Date();
-            context.xSubscription = {
-                id: BigInt(99999),
-                userId: context.xUser.userId,
-                paySubscriptionId: 'MOCK-PAY-SUB-ID',
-                orderId: '',
-                priceId: '',
-                priceName: 'MOCK-TEST',
-                status: 'active',
-                creditsAllocated: 0,
-                subPeriodStart: viewLocalTime(now),
-                subPeriodEnd: viewLocalTime(now),
-            };
-        }
-        return context.xSubscription;
-    };
-    switch (mockType) {
-        case 0: {
-            const subscription = ensureSubscription();
-            subscription.status = '';
-            subscription.priceId = '';
-            break;
-        }
-        case 1: {
-            const subscription = ensureSubscription();
-            subscription.priceId =
-                process.env.STRIPE_PRO_MONTHLY_PRICE_ID || subscription.priceId;
-            break;
-        }
-        case 2: {
-            const subscription = ensureSubscription();
-            subscription.priceId =
-                process.env.STRIPE_ULTRA_MONTHLY_PRICE_ID || subscription.priceId;
-            break;
-        }
-        case 3: {
-            const subscription = ensureSubscription();
-            subscription.priceId =
-                process.env.STRIPE_PRO_YEARLY_PRICE_ID || subscription.priceId;
-            break;
-        }
-        case 4: {
-            const subscription = ensureSubscription();
-            subscription.priceId =
-                process.env.STRIPE_ULTRA_YEARLY_PRICE_ID || subscription.priceId;
-            break;
-        }
-    }
-    return context;
-}
 
-export { applyUserMockContext, buildInitUserContextFromEntities, fetchLatestUserContextByFingerprintId, fetchUserContextByClerkUserId, mapCreditToXCredit, mapSubscriptionToXSubscription, mapUserToXUser };
+export { buildInitUserContextFromEntities, fetchLatestUserContextByFingerprintId, fetchUserContextByClerkUserId, mapCreditToXCredit, mapSubscriptionToXSubscription, mapUserToXUser };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/backend-core",
-  "version": "14.1.1",
+  "version": "14.3.0",
   "description": "Shared backend primitives: Prisma schema/client, database services, routing helpers",
   "type": "module",
   "main": "./dist/index.js",
@@ -85,17 +85,17 @@
   ],
   "dependencies": {
     "@clerk/nextjs": "^7.0.5",
-    "@prisma/client": "^6.17.1",
+    "@prisma/client": "^6.19.0",
     "@upstash/redis": "^1.34.0",
     "@upstash/qstash": "^2.7.0",
     "@upstash/lock": "^0.2.1",
     "next": "16.1.6",
-    "prisma": "^6.17.1",
+    "prisma": "^6.19.0",
     "stripe": "20.0.0",
     "svix": "^1.86.0",
     "zod": "^4.3.6",
-    "@windrun-huaiin/lib": "^14.0.0",
-    "@windrun-huaiin/third-ui": "^14.0.2"
+    "@windrun-huaiin/lib": "^14.0.1",
+    "@windrun-huaiin/third-ui": "^14.2.0"
   },
   "devDependencies": {
     "@rollup/plugin-alias": "^5.1.1",
@@ -108,9 +108,9 @@
   },
   "peerDependencies": {
     "@clerk/nextjs": "^7.0.5",
-    "@prisma/client": "^6.17.1",
+    "@prisma/client": "^6.19.0",
     "next": "16.1.6",
-    "prisma": "^6.17.1",
+    "prisma": "^6.19.0",
     "stripe": "20.0.0",
     "svix": "^1.86.0"
   },

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

@@ -5,13 +5,12 @@
   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';
 import { NextRequest, NextResponse } from 'next/server';
 import {
-  applyUserMockContext,
   fetchLatestUserContextByFingerprintId,
   fetchUserContextByClerkUserId,
   mapCreditToXCredit,
@@ -19,6 +18,8 @@ import {
   mapUserToXUser,
   type UserContextEntities,
 } from '@/context/user-context-service';
+import { finalizeUserContext } from '@/context/user-context-finalizer';
+
 import type { Prisma } from '@/db/prisma-model-type';
 
 
@@ -60,7 +61,7 @@ function createSuccessResponse(params: {
     ...params.options,
   };
 
-  return applyUserMockContext(response);
+  return finalizeUserContext(response);
 }
 
 /** 创建错误响应 */
@@ -306,6 +307,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 +460,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 +482,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 +532,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 +679,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/lib/money-price-helper.ts

@@ -5,9 +5,9 @@ import {
 } from '@windrun-huaiin/third-ui/fingerprint/server';
 import type { InitUserContext } from '@windrun-huaiin/third-ui/main/server';
 import {
-  applyUserMockContext,
   buildInitUserContextFromEntities,
   fetchUserContextByClerkUserId,
+  finalizeUserContext,
 } from '../services/context';
 
 async function readFingerprintIdFromRequest(): Promise<string | null> {
@@ -42,7 +42,7 @@ export async function getMoneyPriceInitUserContext(): Promise<InitUserContext> {
       isClerkAuthenticated: true,
     });
 
-    return applyUserMockContext(initUserContext);
+    return finalizeUserContext(initUserContext);
   }
 
   const fingerprintId = await readFingerprintIdFromRequest();
@@ -58,4 +58,4 @@ export async function getMoneyPriceInitUserContext(): Promise<InitUserContext> {
     xSubscription: null,
     isClerkAuthenticated: false,
   };
-}
+}

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';

package/src/services/context/index.ts

@@ -1 +1,2 @@
-export * from './user-context-service';
+export * from './user-context-service';
+export * from './user-context-finalizer';