@windrun-huaiin/backend-core 31.0.0 → 31.0.1

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

@@ -1,564 +1,17 @@
-import { __awaiter, __rest } from 'tslib';
-import { anonymousAggregateService } from '../../../../../services/aggregate/anonymous.aggregate.service.mjs';
+import { __awaiter } from 'tslib';
 import { getOptionalServerAuthIdentity } from '../../../../../auth/auth-utils.mjs';
-import { extractFingerprintFromNextRequest } from '@windrun-huaiin/third-ui/fingerprint/server';
-import { NextResponse } from 'next/server';
-import { fetchUserContextByClerkUserId, fetchLatestUserContextByFingerprintId, mapSubscriptionToXSubscription, mapCreditToXCredit, mapUserToXUser } from '../../../../../services/context/user-context-service.mjs';
-import { finalizeUserContext } from '../../../../../services/context/user-context-finalizer.mjs';
+import { handleFingerprintRequest } from './route-shared.mjs';
 
-/* eslint-disable @typescript-eslint/no-explicit-any */
-// Fix BigInt serialization issue
-BigInt.prototype.toJSON = function () {
-    return this.toString();
-};
-// ==================== Utilities ====================
-/** Create a successful response payload */
-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 finalizeUserContext(response);
-}
-/** Create an error response */
-function createErrorResponse(message, status = 400) {
-    const errorResponse = { error: message };
-    return NextResponse.json(errorResponse, { status });
-}
-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;
-    }
-    const trimmed = ref.trim();
-    if (!trimmed) {
-        return null;
-    }
-    return trimmed.length > SOURCE_REF_MAX_LENGTH
-        ? trimmed.slice(0, SOURCE_REF_MAX_LENGTH)
-        : trimmed;
-}
-function normalizeQueryParam(value) {
-    if (!value) {
-        return null;
-    }
-    const trimmed = value.trim();
-    if (!trimmed) {
-        return null;
-    }
-    return trimmed.length > QUERY_PARAM_MAX_LENGTH
-        ? 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) {
-            return;
-        }
-        const normalized = normalizeQueryParam(value);
-        if (normalized) {
-            sourceRef[key] = normalized;
-        }
-    };
-    setIfEmpty('utmSource', params.get('utm_source'));
-    setIfEmpty('utmMedium', params.get('utm_medium'));
-    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';
-}
-// Extract the user's first-touch attribution source.
-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');
-    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 = [customRef, headerRef];
-    for (const candidate of candidates) {
-        const normalized = normalizeSourceRef(candidate);
-        if (normalized) {
-            normalizedHttpRef = normalized;
-            sourceRef.httpRefer = (_j = sourceRef.httpRefer) !== null && _j !== void 0 ? _j : normalized;
-            break;
-        }
-    }
-    const searchParams = request.nextUrl.searchParams;
-    applySearchParams(sourceRef, searchParams);
-    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;
-}
 /**
- * Query the user by Clerk user ID and return response data.
- */
-function getUserByClerkId(clerkUserId) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const entities = yield fetchUserContextByClerkUserId(clerkUserId);
-        if (!entities) {
-            return null;
-        }
-        return createSuccessResponse({
-            entities,
-            isNewUser: false,
-        });
-    });
-}
-/**
- * Query the user by fingerprint ID and return response data.
- */
-function getUserByFingerprintId(fingerprintId) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const result = yield fetchLatestUserContextByFingerprintId(fingerprintId);
-        if (!result) {
-            return null;
-        }
-        const { totalUsersOnDevice, hasAnonymousUser } = result, entities = __rest(result, ["totalUsersOnDevice", "hasAnonymousUser"]);
-        return createSuccessResponse({
-            entities,
-            isNewUser: false,
-            options: {
-                totalUsersOnDevice,
-                hasAnonymousUser,
-            },
-        });
-    });
-}
-/**
- * Shared fingerprint request handling logic.
- */
-function handleFingerprintRequest(request_1) {
-    return __awaiter(this, arguments, void 0, function* (request, options = {}) {
-        var _a;
-        // Extract the fingerprint ID from the request.
-        const fingerprintId = extractFingerprintFromNextRequest(request);
-        // Validate the fingerprint ID.
-        if (!fingerprintId) {
-            return createErrorResponse('Invalid or missing fingerprint ID');
-        }
-        console.log('Received fingerprintId:', fingerprintId);
-        const authIdentity = yield getOptionalServerAuthIdentity();
-        const clerkUserId = (_a = authIdentity === null || authIdentity === void 0 ? void 0 : authIdentity.providerUserId) !== null && _a !== void 0 ? _a : null;
-        try {
-            // Prefer Clerk user ID lookup when the user is authenticated.
-            let existingUserResult = null;
-            if (clerkUserId) {
-                // Authenticated users are always resolved by clerkUserId.
-                existingUserResult = yield getUserByClerkId(clerkUserId);
-                if (existingUserResult && existingUserResult.xUser.fingerprintId !== fingerprintId) {
-                    // The authenticated user's fingerprint changed. Clerk still identifies the account as the same user.
-                    // Trust clerkUserId as the source of truth and keep resolving the user's own data by login identity.
-                    // A single fingerprint can be associated with multiple accounts, so no mutation is needed here.
-                    console.warn(`Current login user used diff fp_ids: ${clerkUserId}, db_fp_id=${existingUserResult.xUser.fingerprintId}, req_fp_id=${fingerprintId}`);
-                }
-            }
-            else {
-                // For anonymous requests, fall back to fingerprint lookup.
-                existingUserResult = yield getUserByFingerprintId(fingerprintId);
-            }
-            if (existingUserResult) {
-                return NextResponse.json(existingUserResult);
-            }
-            // If the user does not exist and creation is disabled, return 404.
-            if (!options.createIfNotExists) {
-                return createErrorResponse('User not found', 404);
-            }
-            const sourceRef = extractSourceRef(request);
-            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}`);
-            }
-            // Return the created or existing context.
-            const response = createSuccessResponse({
-                entities: {
-                    user: anonymousInitResult.user,
-                    credit: anonymousInitResult.credit,
-                    subscription: anonymousInitResult.subscription,
-                },
-                isNewUser: anonymousInitResult.isNewUser,
-                options: {
-                    totalUsersOnDevice: anonymousInitResult.totalUsersOnDevice,
-                    hasAnonymousUser: anonymousInitResult.hasAnonymousUser,
-                },
-            });
-            return NextResponse.json(response);
-        }
-        catch (error) {
-            console.error('Fingerprint request error:', error);
-            return createErrorResponse('Internal server error', 500);
-        }
-    });
-}
-/**
- * Anonymous user initialization API.
+ * Clerk-aware anonymous user initialization API.
  * POST /api/user/anonymous/init
  */
 function POST(request) {
     return __awaiter(this, void 0, void 0, function* () {
-        return handleFingerprintRequest(request, { createIfNotExists: true });
+        return handleFingerprintRequest(request, {
+            createIfNotExists: true,
+            getAuthIdentity: getOptionalServerAuthIdentity,
+        });
     });
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/backend-core",
-  "version": "31.0.0",
+  "version": "31.0.1",
   "description": "Shared backend primitives: Prisma schema/client, database services, routing helpers",
   "type": "module",
   "main": "./dist/index.js",
@@ -107,6 +107,11 @@
       "import": "./dist/app/api/user/anonymous/init/route.mjs",
       "require": "./dist/app/api/user/anonymous/init/route.js"
     },
+    "./app/api/user/anonymous/init/fingerprint-only-route": {
+      "types": "./dist/app/api/user/anonymous/init/fingerprint-only-route.d.ts",
+      "import": "./dist/app/api/user/anonymous/init/fingerprint-only-route.mjs",
+      "require": "./dist/app/api/user/anonymous/init/fingerprint-only-route.js"
+    },
     "./app/api/user/credit-overview/route": {
       "types": "./dist/app/api/user/credit-overview/route.d.ts",
       "import": "./dist/app/api/user/credit-overview/route.mjs",
@@ -148,9 +153,9 @@
     "svix": "^1.86.0",
     "tslib": "^2.8.1",
     "zod": "^4.3.6",
-    "@windrun-huaiin/lib": "^31.0.0",
-    "@windrun-huaiin/third-ui": "^31.0.0",
-    "@windrun-huaiin/contracts": "^31.0.0"
+    "@windrun-huaiin/lib": "^31.0.2",
+    "@windrun-huaiin/contracts": "^31.0.0",
+    "@windrun-huaiin/third-ui": "^31.3.1"
   },
   "devDependencies": {
     "@rollup/plugin-alias": "^5.1.1",

package/src/app/api/user/anonymous/init/fingerprint-only-route.ts

@@ -0,0 +1,14 @@
+import { handleFingerprintRequest } from './route-shared';
+import type { NextRequest } from 'next/server';
+
+/**
+ * Fingerprint-only anonymous user initialization API.
+ * Use this route in apps that do not install or configure Clerk.
+ * POST /api/user/anonymous/init
+ */
+export async function POST(request: NextRequest) {
+  return handleFingerprintRequest(request, {
+    createIfNotExists: true,
+    getAuthIdentity: async () => null,
+  });
+}