@windrun-huaiin/backend-core 14.1.0 → 14.2.0

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';
@@ -23,6 +23,9 @@ function createErrorResponse(message, status = 400) {
 }
 const SOURCE_REF_MAX_LENGTH = 2048;
 const QUERY_PARAM_MAX_LENGTH = 512;
+const USER_AGENT_MAX_LENGTH = 1024;
+const FIRST_TOUCH_HEADER_MAX_LENGTH = 4096;
+const FIRST_TOUCH_HEADER_NAME = 'x-first-touch';
 function normalizeSourceRef(ref) {
     if (!ref) {
         return null;
@@ -47,6 +50,28 @@ function normalizeQueryParam(value) {
         ? trimmed.slice(0, QUERY_PARAM_MAX_LENGTH)
         : trimmed;
 }
+function decodeHeaderValue(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+function mergeSourceRef(target, source) {
+    if (!source) {
+        return;
+    }
+    const entries = Object.entries(source);
+    for (const [key, value] of entries) {
+        if (value === undefined || value === null) {
+            continue;
+        }
+        if (target[key] === undefined) {
+            target[key] = value;
+        }
+    }
+}
 function applySearchParams(sourceRef, params) {
     const setIfEmpty = (key, value) => {
         if (sourceRef[key] !== undefined) {
@@ -62,26 +87,350 @@ function applySearchParams(sourceRef, params) {
     setIfEmpty('utmCampaign', params.get('utm_campaign'));
     setIfEmpty('utmTerm', params.get('utm_term'));
     setIfEmpty('utmContent', params.get('utm_content'));
+    setIfEmpty('utmId', params.get('utm_id'));
     setIfEmpty('ref', params.get('ref'));
+    setIfEmpty('gclid', params.get('gclid'));
+    setIfEmpty('fbclid', params.get('fbclid'));
+    setIfEmpty('msclkid', params.get('msclkid'));
+    setIfEmpty('ttclid', params.get('ttclid'));
+    setIfEmpty('twclid', params.get('twclid'));
+    setIfEmpty('liFatId', params.get('li_fat_id'));
+}
+function normalizeHost(host) {
+    if (!host) {
+        return null;
+    }
+    return host.trim().toLowerCase() || null;
+}
+function getRootDomain(host) {
+    const normalizedHost = normalizeHost(host);
+    if (!normalizedHost) {
+        return null;
+    }
+    const hostname = normalizedHost.split(':')[0];
+    if (hostname === 'localhost' || /^\d{1,3}(\.\d{1,3}){3}$/.test(hostname)) {
+        return hostname;
+    }
+    const parts = hostname.split('.').filter(Boolean);
+    if (parts.length <= 2) {
+        return hostname;
+    }
+    return parts.slice(-2).join('.');
+}
+function isInternalReferer(landingHost, refererHost) {
+    const normalizedLandingHost = normalizeHost(landingHost);
+    const normalizedRefererHost = normalizeHost(refererHost);
+    if (!normalizedLandingHost || !normalizedRefererHost) {
+        return false;
+    }
+    if (normalizedLandingHost === normalizedRefererHost) {
+        return true;
+    }
+    return normalizedLandingHost.endsWith(`.${normalizedRefererHost}`)
+        || normalizedRefererHost.endsWith(`.${normalizedLandingHost}`);
+}
+function detectPlatform(value) {
+    const normalized = value === null || value === void 0 ? void 0 : value.trim().toLowerCase();
+    if (!normalized) {
+        return null;
+    }
+    const matcherList = [
+        { pattern: /chatgpt|chat-openai|openai/, platform: 'openai', channel: 'ai' },
+        { pattern: /claude|anthropic/, platform: 'anthropic', channel: 'ai' },
+        { pattern: /perplexity/, platform: 'perplexity', channel: 'ai' },
+        { pattern: /gemini/, platform: 'gemini', channel: 'ai' },
+        { pattern: /copilot/, platform: 'copilot', channel: 'ai' },
+        { pattern: /google/, platform: 'google', channel: 'search' },
+        { pattern: /bing/, platform: 'bing', channel: 'search' },
+        { pattern: /baidu/, platform: 'baidu', channel: 'search' },
+        { pattern: /yahoo/, platform: 'yahoo', channel: 'search' },
+        { pattern: /duckduckgo/, platform: 'duckduckgo', channel: 'search' },
+        { pattern: /facebook/, platform: 'facebook', channel: 'social' },
+        { pattern: /instagram/, platform: 'instagram', channel: 'social' },
+        { pattern: /x\.com|twitter/, platform: 'x', channel: 'social' },
+        { pattern: /linkedin/, platform: 'linkedin', channel: 'social' },
+        { pattern: /reddit/, platform: 'reddit', channel: 'social' },
+        { pattern: /youtube/, platform: 'youtube', channel: 'social' },
+    ];
+    const matched = matcherList.find(({ pattern }) => pattern.test(normalized));
+    if (!matched) {
+        return null;
+    }
+    return matched.platform;
+}
+function detectChannelFromPlatform(platform) {
+    switch (platform) {
+        case 'openai':
+        case 'anthropic':
+        case 'perplexity':
+        case 'gemini':
+        case 'copilot':
+            return 'ai';
+        case 'google':
+        case 'bing':
+        case 'baidu':
+        case 'yahoo':
+        case 'duckduckgo':
+            return 'search';
+        case 'facebook':
+        case 'instagram':
+        case 'x':
+        case 'linkedin':
+        case 'reddit':
+        case 'youtube':
+            return 'social';
+        default:
+            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');
+    const secChUaMobile = (_a = normalizeQueryParam(request.headers.get('sec-ch-ua-mobile'))) !== null && _a !== void 0 ? _a : undefined;
+    const secChUaPlatform = (_b = normalizeQueryParam(request.headers.get('sec-ch-ua-platform'))) !== null && _b !== void 0 ? _b : undefined;
+    const userAgent = (_d = (_c = normalizeSourceRef(userAgentHeader)) === null || _c === void 0 ? void 0 : _c.slice(0, USER_AGENT_MAX_LENGTH)) !== null && _d !== void 0 ? _d : undefined;
+    const ua = (_e = userAgent === null || userAgent === void 0 ? void 0 : userAgent.toLowerCase()) !== null && _e !== void 0 ? _e : '';
+    let deviceType = 'desktop';
+    if (!ua) {
+        deviceType = 'unknown';
+    }
+    else if (/bot|spider|crawler|curl|wget|headless/.test(ua)) {
+        deviceType = 'bot';
+    }
+    else if (/ipad|tablet/.test(ua)) {
+        deviceType = 'tablet';
+    }
+    else if (/mobi|iphone|android/.test(ua) || secChUaMobile === '?1') {
+        deviceType = 'mobile';
+    }
+    let os = 'Unknown';
+    if (/iphone|ipad|ipod/.test(ua)) {
+        os = 'iOS';
+    }
+    else if (/android/.test(ua)) {
+        os = 'Android';
+    }
+    else if (/windows nt/.test(ua)) {
+        os = 'Windows';
+    }
+    else if (/mac os x|macintosh/.test(ua)) {
+        os = 'macOS';
+    }
+    else if (/cros/.test(ua)) {
+        os = 'Chrome OS';
+    }
+    else if (/linux/.test(ua)) {
+        os = 'Linux';
+    }
+    if (secChUaPlatform) {
+        const normalizedPlatform = secChUaPlatform.replaceAll('"', '');
+        if (normalizedPlatform && normalizedPlatform !== 'Unknown') {
+            os = normalizedPlatform;
+        }
+    }
+    let browser = 'Unknown';
+    if (/edg\//.test(ua)) {
+        browser = 'Edge';
+    }
+    else if (/opr\//.test(ua) || /opera/.test(ua)) {
+        browser = 'Opera';
+    }
+    else if (/samsungbrowser\//.test(ua)) {
+        browser = 'Samsung Internet';
+    }
+    else if (/crios\//.test(ua) || /chrome\//.test(ua)) {
+        browser = 'Chrome';
+    }
+    else if (/firefox\//.test(ua)) {
+        browser = 'Firefox';
+    }
+    else if (/safari\//.test(ua) && !/chrome\//.test(ua) && !/crios\//.test(ua)) {
+        browser = 'Safari';
+    }
+    return {
+        userAgent,
+        deviceType,
+        os,
+        browser,
+        secChUaMobile,
+        secChUaPlatform,
+    };
+}
+function parseFirstTouchHeader(request) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w;
+    const rawHeader = request.headers.get(FIRST_TOUCH_HEADER_NAME);
+    const normalizedHeader = (_a = normalizeSourceRef(rawHeader)) === null || _a === void 0 ? void 0 : _a.slice(0, FIRST_TOUCH_HEADER_MAX_LENGTH);
+    if (!normalizedHeader) {
+        return null;
+    }
+    const decodedHeader = decodeHeaderValue(normalizedHeader);
+    if (!decodedHeader) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(decodedHeader);
+        const sourceRef = {};
+        sourceRef.capturedAt = (_b = normalizeQueryParam(typeof parsed.capturedAt === 'string' ? parsed.capturedAt : null)) !== null && _b !== void 0 ? _b : undefined;
+        sourceRef.landingUrl = (_c = normalizeSourceRef(typeof parsed.landingUrl === 'string' ? parsed.landingUrl : null)) !== null && _c !== void 0 ? _c : undefined;
+        sourceRef.landingPath = (_d = normalizeSourceRef(typeof parsed.landingPath === 'string' ? parsed.landingPath : null)) !== null && _d !== void 0 ? _d : undefined;
+        sourceRef.landingHost = (_e = normalizeHost(typeof parsed.landingHost === 'string' ? parsed.landingHost : null)) !== null && _e !== void 0 ? _e : undefined;
+        sourceRef.ref = (_f = normalizeQueryParam(typeof parsed.ref === 'string' ? parsed.ref : null)) !== null && _f !== void 0 ? _f : undefined;
+        sourceRef.utmSource = (_g = normalizeQueryParam(typeof parsed.utmSource === 'string' ? parsed.utmSource : null)) !== null && _g !== void 0 ? _g : undefined;
+        sourceRef.utmMedium = (_h = normalizeQueryParam(typeof parsed.utmMedium === 'string' ? parsed.utmMedium : null)) !== null && _h !== void 0 ? _h : undefined;
+        sourceRef.utmCampaign = (_j = normalizeQueryParam(typeof parsed.utmCampaign === 'string' ? parsed.utmCampaign : null)) !== null && _j !== void 0 ? _j : undefined;
+        sourceRef.utmTerm = (_k = normalizeQueryParam(typeof parsed.utmTerm === 'string' ? parsed.utmTerm : null)) !== null && _k !== void 0 ? _k : undefined;
+        sourceRef.utmContent = (_l = normalizeQueryParam(typeof parsed.utmContent === 'string' ? parsed.utmContent : null)) !== null && _l !== void 0 ? _l : undefined;
+        sourceRef.utmId = (_m = normalizeQueryParam(typeof parsed.utmId === 'string' ? parsed.utmId : null)) !== null && _m !== void 0 ? _m : undefined;
+        sourceRef.gclid = (_o = normalizeQueryParam(typeof parsed.gclid === 'string' ? parsed.gclid : null)) !== null && _o !== void 0 ? _o : undefined;
+        sourceRef.fbclid = (_p = normalizeQueryParam(typeof parsed.fbclid === 'string' ? parsed.fbclid : null)) !== null && _p !== void 0 ? _p : undefined;
+        sourceRef.msclkid = (_q = normalizeQueryParam(typeof parsed.msclkid === 'string' ? parsed.msclkid : null)) !== null && _q !== void 0 ? _q : undefined;
+        sourceRef.ttclid = (_r = normalizeQueryParam(typeof parsed.ttclid === 'string' ? parsed.ttclid : null)) !== null && _r !== void 0 ? _r : undefined;
+        sourceRef.twclid = (_s = normalizeQueryParam(typeof parsed.twclid === 'string' ? parsed.twclid : null)) !== null && _s !== void 0 ? _s : undefined;
+        sourceRef.liFatId = (_t = normalizeQueryParam(typeof parsed.liFatId === 'string' ? parsed.liFatId : null)) !== null && _t !== void 0 ? _t : undefined;
+        const externalReferrer = normalizeSourceRef(typeof parsed.externalReferrer === 'string' ? parsed.externalReferrer : null);
+        if (externalReferrer) {
+            sourceRef.httpRefer = externalReferrer;
+            try {
+                const refererUrl = new URL(externalReferrer);
+                sourceRef.refererHost = (_u = normalizeHost(refererUrl.host)) !== null && _u !== void 0 ? _u : undefined;
+                sourceRef.refererPath = (_v = normalizeSourceRef(refererUrl.pathname)) !== null && _v !== void 0 ? _v : undefined;
+                sourceRef.refererDomain = (_w = getRootDomain(refererUrl.host)) !== null && _w !== void 0 ? _w : undefined;
+                applySearchParams(sourceRef, refererUrl.searchParams);
+            }
+            catch (error) {
+                console.warn('Failed to parse first-touch referrer url:', error);
+            }
+        }
+        return Object.keys(sourceRef).length > 0 ? sourceRef : null;
+    }
+    catch (error) {
+        console.warn('Failed to parse first-touch header:', error);
+        return null;
+    }
+}
+function finalizeAttribution(sourceRef) {
+    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 = (_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;
+    }
+    if (sourceRef.gclid) {
+        sourceRef.sourcePlatform = 'google';
+        sourceRef.sourceChannel = 'search';
+        sourceRef.sourceType = 'campaign';
+        return;
+    }
+    if (sourceRef.msclkid) {
+        sourceRef.sourcePlatform = 'bing';
+        sourceRef.sourceChannel = 'search';
+        sourceRef.sourceType = 'campaign';
+        return;
+    }
+    if (sourceRef.fbclid) {
+        sourceRef.sourcePlatform = 'facebook';
+        sourceRef.sourceChannel = 'social';
+        sourceRef.sourceType = 'campaign';
+        return;
+    }
+    if (sourceRef.ttclid) {
+        sourceRef.sourcePlatform = 'tiktok';
+        sourceRef.sourceChannel = 'social';
+        sourceRef.sourceType = 'campaign';
+        return;
+    }
+    if (sourceRef.twclid) {
+        sourceRef.sourcePlatform = 'x';
+        sourceRef.sourceChannel = 'social';
+        sourceRef.sourceType = 'campaign';
+        return;
+    }
+    if (sourceRef.liFatId) {
+        sourceRef.sourcePlatform = 'linkedin';
+        sourceRef.sourceChannel = 'social';
+        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 = refererPlatform !== null && refererPlatform !== void 0 ? refererPlatform : 'other';
+        sourceRef.sourceChannel = (_e = detectChannelFromPlatform(refererPlatform)) !== null && _e !== void 0 ? _e : 'referral';
+        sourceRef.sourceType = 'referer';
+        return;
+    }
+    sourceRef.sourcePlatform = 'direct';
+    sourceRef.sourceChannel = 'direct';
+    sourceRef.sourceType = 'direct';
 }
 // 提取用户首次访问来源
 function extractSourceRef(request) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
     const headerRef = request.headers.get('referer') || request.headers.get('referrer');
     const customRef = request.headers.get('x-source-ref');
     const queryRef = request.nextUrl.searchParams.get('ref');
-    console.log({
-        headerRef,
-        customRef,
-        queryRef
-    });
-    const sourceRef = {};
+    const firstTouchRef = parseFirstTouchHeader(request);
+    const sourceRef = Object.assign({}, parseUserAgent(request));
+    mergeSourceRef(sourceRef, firstTouchRef);
+    sourceRef.landingUrl = (_b = (_a = sourceRef.landingUrl) !== null && _a !== void 0 ? _a : normalizeSourceRef(request.nextUrl.toString())) !== null && _b !== void 0 ? _b : undefined;
+    sourceRef.landingPath = (_d = (_c = sourceRef.landingPath) !== null && _c !== void 0 ? _c : normalizeSourceRef(request.nextUrl.pathname)) !== null && _d !== void 0 ? _d : undefined;
+    sourceRef.landingHost = (_f = (_e = sourceRef.landingHost) !== null && _e !== void 0 ? _e : normalizeHost(request.nextUrl.host)) !== null && _f !== void 0 ? _f : undefined;
+    sourceRef.ref = (_h = (_g = sourceRef.ref) !== null && _g !== void 0 ? _g : normalizeQueryParam(queryRef)) !== null && _h !== void 0 ? _h : undefined;
     let normalizedHttpRef = null;
-    const candidates = [headerRef, customRef, queryRef];
+    const candidates = [customRef, headerRef];
     for (const candidate of candidates) {
         const normalized = normalizeSourceRef(candidate);
         if (normalized) {
             normalizedHttpRef = normalized;
-            sourceRef.httpRefer = normalized;
+            sourceRef.httpRefer = (_j = sourceRef.httpRefer) !== null && _j !== void 0 ? _j : normalized;
             break;
         }
     }
@@ -90,12 +439,16 @@ function extractSourceRef(request) {
     if (normalizedHttpRef) {
         try {
             const refererUrl = new URL(normalizedHttpRef);
+            sourceRef.refererHost = (_l = (_k = sourceRef.refererHost) !== null && _k !== void 0 ? _k : normalizeHost(refererUrl.host)) !== null && _l !== void 0 ? _l : undefined;
+            sourceRef.refererPath = (_o = (_m = sourceRef.refererPath) !== null && _m !== void 0 ? _m : normalizeSourceRef(refererUrl.pathname)) !== null && _o !== void 0 ? _o : undefined;
+            sourceRef.refererDomain = (_q = (_p = sourceRef.refererDomain) !== null && _p !== void 0 ? _p : getRootDomain(refererUrl.host)) !== null && _q !== void 0 ? _q : undefined;
             applySearchParams(sourceRef, refererUrl.searchParams);
         }
         catch (error) {
             console.warn('Failed to parse referer url for utm/ref:', error);
         }
     }
+    finalizeAttribution(sourceRef);
     return Object.keys(sourceRef).length > 0 ? sourceRef : null;
 }
 /**
@@ -172,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;