@windrun-huaiin/backend-core 14.0.0 → 14.1.1

package/dist/prisma/prisma.d.ts

@@ -1,4 +1,4 @@
 import { PrismaClient, Prisma } from '@prisma/client';
-export declare const prisma: any;
+export declare const prisma: PrismaClient<Prisma.PrismaClientOptions, never, import("@prisma/client/runtime/library").DefaultArgs>;
 export declare function checkAndFallbackWithNonTCClient(tx?: Prisma.TransactionClient): Prisma.TransactionClient | PrismaClient;
 //# sourceMappingURL=prisma.d.ts.map

package/dist/prisma/prisma.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prisma.d.ts","sourceRoot":"","sources":["../../src/prisma/prisma.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAgCtD,eAAO,MAAM,MAAM,KAIf,CAAC;AAmFL,wBAAgB,+BAA+B,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,GAAG,YAAY,CAEtH"}
+{"version":3,"file":"prisma.d.ts","sourceRoot":"","sources":["../../src/prisma/prisma.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAgCtD,eAAO,MAAM,MAAM,uGAIf,CAAC;AAmFL,wBAAgB,+BAA+B,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,GAAG,YAAY,CAEtH"}

package/dist/services/stripe/webhook-handler.js

@@ -122,9 +122,10 @@ function handleSubscriptionCheckoutInit(session, transaction) {
             throw new Error('No subscription ID in checkout session');
         }
         const subscriptionId = session.subscription;
+        const stripe = stripeConfig.getStripe();
         // ===== STEP 1: FETCH EXTERNAL API DATA (BEFORE TRANSACTION) =====
         // 2. Get COMPLETE Stripe subscription details including billing period
-        const stripeSubscription = yield stripeConfig.stripe.subscriptions.retrieve(subscriptionId);
+        const stripeSubscription = yield stripe.subscriptions.retrieve(subscriptionId);
         // Extract billing period from subscription items (NOT from top-level subscription object)
         // The current_period_start/end are on SubscriptionItem, not on Subscription
         const subscriptionItem = (_b = (_a = stripeSubscription.items) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b[0];
@@ -343,8 +344,9 @@ function handleSubscriptionDeleted(stripeSubscription) {
 function handleAsyncPaymentSucceeded(session) {
     return tslib_es6.__awaiter(this, void 0, void 0, function* () {
         console.log(`Async payment succeeded: ${session.id}`);
+        const stripe = stripeConfig.getStripe();
         // Retrieve the latest session state to ensure payment_status is up to date
-        const latestSession = yield stripeConfig.stripe.checkout.sessions.retrieve(session.id);
+        const latestSession = yield stripe.checkout.sessions.retrieve(session.id);
         return yield handleCheckoutCompleted(latestSession);
     });
 }

package/dist/services/stripe/webhook-handler.mjs

@@ -9,7 +9,7 @@ import '@prisma/client';
 import { Apilogger } from '../database/apilog.service.mjs';
 import { oneTimeExpiredDays } from '../../lib/credit-init.mjs';
 import { getCreditsFromPriceId } from '../../lib/money-price-config.mjs';
-import { stripe, fetchPaymentId } from '../../lib/stripe-config.mjs';
+import { getStripe, fetchPaymentId } from '../../lib/stripe-config.mjs';
 import { viewLocalTime } from '@windrun-huaiin/lib/utils';
 
 /* eslint-disable @typescript-eslint/no-explicit-any */
@@ -120,6 +120,7 @@ function handleSubscriptionCheckoutInit(session, transaction) {
             throw new Error('No subscription ID in checkout session');
         }
         const subscriptionId = session.subscription;
+        const stripe = getStripe();
         // ===== STEP 1: FETCH EXTERNAL API DATA (BEFORE TRANSACTION) =====
         // 2. Get COMPLETE Stripe subscription details including billing period
         const stripeSubscription = yield stripe.subscriptions.retrieve(subscriptionId);
@@ -341,6 +342,7 @@ function handleSubscriptionDeleted(stripeSubscription) {
 function handleAsyncPaymentSucceeded(session) {
     return __awaiter(this, void 0, void 0, function* () {
         console.log(`Async payment succeeded: ${session.id}`);
+        const stripe = getStripe();
         // Retrieve the latest session state to ensure payment_status is up to date
         const latestSession = yield stripe.checkout.sessions.retrieve(session.id);
         return yield handleCheckoutCompleted(latestSession);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/backend-core",
-  "version": "14.0.0",
+  "version": "14.1.1",
   "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.0"
+    "@windrun-huaiin/third-ui": "^14.0.2"
   },
   "devDependencies": {
     "@rollup/plugin-alias": "^5.1.1",

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

@@ -6,7 +6,7 @@
 };
 
 import { userAggregateService } from '@/aggregate/user.aggregate.service';
-import { XCredit, XSubscription, XUser } from '@windrun-huaiin/third-ui/fingerprint';
+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';
@@ -70,19 +70,59 @@ function createErrorResponse(message: string, status = 400): NextResponse {
 }
 
 type SourceRefData = Prisma.InputJsonObject & {
+  capturedAt?: string;
+  landingUrl?: string;
+  landingPath?: string;
+  landingHost?: string;
   httpRefer?: string;
+  refererHost?: string;
+  refererPath?: string;
+  refererDomain?: string;
+  sourceType?: string;
+  sourceChannel?: string;
+  sourcePlatform?: string;
+  isInternalReferer?: boolean;
   utmSource?: string;
   utmMedium?: string;
   utmCampaign?: string;
   utmTerm?: string;
   utmContent?: string;
+  utmId?: string;
   ref?: string;
+  gclid?: string;
+  fbclid?: string;
+  msclkid?: string;
+  ttclid?: string;
+  twclid?: string;
+  liFatId?: string;
+  userAgent?: string;
+  deviceType?: string;
+  os?: string;
+  browser?: string;
+  secChUaMobile?: string;
+  secChUaPlatform?: string;
 };
 
-type SourceRefKey = 'utmSource' | 'utmMedium' | 'utmCampaign' | 'utmTerm' | 'utmContent' | 'ref';
+type SourceRefKey =
+  | 'utmSource'
+  | 'utmMedium'
+  | 'utmCampaign'
+  | 'utmTerm'
+  | 'utmContent'
+  | 'utmId'
+  | 'ref'
+  | 'gclid'
+  | 'fbclid'
+  | 'msclkid'
+  | 'ttclid'
+  | 'twclid'
+  | 'liFatId';
 
 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: string | null): string | null {
   if (!ref) {
@@ -114,6 +154,31 @@ function normalizeQueryParam(value: string | null): string | null {
     : trimmed;
 }
 
+function decodeHeaderValue(value: string): string | null {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return null;
+  }
+}
+
+function mergeSourceRef(target: SourceRefData, source: SourceRefData | null | undefined) {
+  if (!source) {
+    return;
+  }
+
+  const entries = Object.entries(source) as Array<[keyof SourceRefData, SourceRefData[keyof SourceRefData]]>;
+  for (const [key, value] of entries) {
+    if (value === undefined || value === null) {
+      continue;
+    }
+
+    if (target[key] === undefined) {
+      (target as Record<string, unknown>)[key as string] = value;
+    }
+  }
+}
+
 function applySearchParams(sourceRef: SourceRefData, params: URLSearchParams) {
   const setIfEmpty = (key: SourceRefKey, value: string | null) => {
     if (sourceRef[key] !== undefined) {
@@ -130,7 +195,306 @@ function applySearchParams(sourceRef: SourceRefData, params: URLSearchParams) {
   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: string | null | undefined): string | null {
+  if (!host) {
+    return null;
+  }
+
+  return host.trim().toLowerCase() || null;
+}
+
+function getRootDomain(host: string | null | undefined): string | null {
+  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: string | null | undefined, refererHost: string | null | undefined): boolean {
+  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: string | null | undefined): string | null {
+  const normalized = value?.trim().toLowerCase();
+  if (!normalized) {
+    return null;
+  }
+
+  const matcherList: Array<{ pattern: RegExp; platform: string; channel: string; }> = [
+    { 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: string | null | undefined): string | null {
+  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 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;
+  const secChUaPlatform = normalizeQueryParam(request.headers.get('sec-ch-ua-platform')) ?? undefined;
+  const userAgent = normalizeSourceRef(userAgentHeader)?.slice(0, USER_AGENT_MAX_LENGTH) ?? undefined;
+  const ua = userAgent?.toLowerCase() ?? '';
+
+  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: NextRequest): SourceRefData | null {
+  const rawHeader = request.headers.get(FIRST_TOUCH_HEADER_NAME);
+  const normalizedHeader = normalizeSourceRef(rawHeader)?.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) as Record<string, unknown>;
+    const sourceRef: SourceRefData = {};
+
+    sourceRef.capturedAt = normalizeQueryParam(typeof parsed.capturedAt === 'string' ? parsed.capturedAt : null) ?? undefined;
+    sourceRef.landingUrl = normalizeSourceRef(typeof parsed.landingUrl === 'string' ? parsed.landingUrl : null) ?? undefined;
+    sourceRef.landingPath = normalizeSourceRef(typeof parsed.landingPath === 'string' ? parsed.landingPath : null) ?? undefined;
+    sourceRef.landingHost = normalizeHost(typeof parsed.landingHost === 'string' ? parsed.landingHost : null) ?? undefined;
+    sourceRef.ref = normalizeQueryParam(typeof parsed.ref === 'string' ? parsed.ref : null) ?? undefined;
+    sourceRef.utmSource = normalizeQueryParam(typeof parsed.utmSource === 'string' ? parsed.utmSource : null) ?? undefined;
+    sourceRef.utmMedium = normalizeQueryParam(typeof parsed.utmMedium === 'string' ? parsed.utmMedium : null) ?? undefined;
+    sourceRef.utmCampaign = normalizeQueryParam(typeof parsed.utmCampaign === 'string' ? parsed.utmCampaign : null) ?? undefined;
+    sourceRef.utmTerm = normalizeQueryParam(typeof parsed.utmTerm === 'string' ? parsed.utmTerm : null) ?? undefined;
+    sourceRef.utmContent = normalizeQueryParam(typeof parsed.utmContent === 'string' ? parsed.utmContent : null) ?? undefined;
+    sourceRef.utmId = normalizeQueryParam(typeof parsed.utmId === 'string' ? parsed.utmId : null) ?? undefined;
+    sourceRef.gclid = normalizeQueryParam(typeof parsed.gclid === 'string' ? parsed.gclid : null) ?? undefined;
+    sourceRef.fbclid = normalizeQueryParam(typeof parsed.fbclid === 'string' ? parsed.fbclid : null) ?? undefined;
+    sourceRef.msclkid = normalizeQueryParam(typeof parsed.msclkid === 'string' ? parsed.msclkid : null) ?? undefined;
+    sourceRef.ttclid = normalizeQueryParam(typeof parsed.ttclid === 'string' ? parsed.ttclid : null) ?? undefined;
+    sourceRef.twclid = normalizeQueryParam(typeof parsed.twclid === 'string' ? parsed.twclid : null) ?? undefined;
+    sourceRef.liFatId = normalizeQueryParam(typeof parsed.liFatId === 'string' ? parsed.liFatId : null) ?? undefined;
+
+    const externalReferrer = normalizeSourceRef(typeof parsed.externalReferrer === 'string' ? parsed.externalReferrer : null);
+    if (externalReferrer) {
+      sourceRef.httpRefer = externalReferrer;
+      try {
+        const refererUrl = new URL(externalReferrer);
+        sourceRef.refererHost = normalizeHost(refererUrl.host) ?? undefined;
+        sourceRef.refererPath = normalizeSourceRef(refererUrl.pathname) ?? undefined;
+        sourceRef.refererDomain = getRootDomain(refererUrl.host) ?? 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: SourceRefData) {
+  const landingHost = normalizeHost(sourceRef.landingHost);
+  const refererHost = normalizeHost(sourceRef.refererHost);
+  const internal = isInternalReferer(landingHost, refererHost);
+  if (internal) {
+    sourceRef.isInternalReferer = true;
+  }
+
+  const utmPlatform = detectPlatform(sourceRef.utmSource) || detectPlatform(sourceRef.ref);
+  if (utmPlatform) {
+    sourceRef.sourcePlatform = utmPlatform;
+    sourceRef.sourceChannel = detectChannelFromPlatform(utmPlatform) ?? sourceRef.sourceChannel ?? '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 (!internal && refererHost) {
+    const refererPlatform = detectPlatform(refererHost) || detectPlatform(sourceRef.httpRefer);
+    sourceRef.sourcePlatform = refererPlatform ?? getRootDomain(refererHost) ?? refererHost;
+    sourceRef.sourceChannel = detectChannelFromPlatform(refererPlatform) ?? 'referral';
+    sourceRef.sourceType = 'referer';
+    return;
+  }
+
+  sourceRef.sourcePlatform = 'direct';
+  sourceRef.sourceChannel = 'direct';
+  sourceRef.sourceType = 'direct';
 }
 
 // 提取用户首次访问来源
@@ -138,21 +502,26 @@ function extractSourceRef(request: NextRequest): SourceRefData | null {
   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 firstTouchRef = parseFirstTouchHeader(request);
+
+  const sourceRef: SourceRefData = {
+    ...parseUserAgent(request),
+  };
 
-  const sourceRef: SourceRefData = {};
+  mergeSourceRef(sourceRef, firstTouchRef);
+
+  sourceRef.landingUrl = sourceRef.landingUrl ?? normalizeSourceRef(request.nextUrl.toString()) ?? undefined;
+  sourceRef.landingPath = sourceRef.landingPath ?? normalizeSourceRef(request.nextUrl.pathname) ?? undefined;
+  sourceRef.landingHost = sourceRef.landingHost ?? normalizeHost(request.nextUrl.host) ?? undefined;
+  sourceRef.ref = sourceRef.ref ?? normalizeQueryParam(queryRef) ?? undefined;
 
   let normalizedHttpRef: string | null = 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 = sourceRef.httpRefer ?? normalized;
       break;
     }
   }
@@ -163,12 +532,17 @@ function extractSourceRef(request: NextRequest): SourceRefData | null {
   if (normalizedHttpRef) {
     try {
       const refererUrl = new URL(normalizedHttpRef);
+      sourceRef.refererHost = sourceRef.refererHost ?? normalizeHost(refererUrl.host) ?? undefined;
+      sourceRef.refererPath = sourceRef.refererPath ?? normalizeSourceRef(refererUrl.pathname) ?? undefined;
+      sourceRef.refererDomain = sourceRef.refererDomain ?? getRootDomain(refererUrl.host) ?? 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;
 }
 

package/src/lib/stripe-config.ts

@@ -1,10 +1,22 @@
 import Stripe from 'stripe';
 import { Apilogger, userService, subscriptionService } from '../services/database/index';
 
-// Stripe Configuration
-export const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!, {
-  apiVersion: '2025-11-17.clover',
-});
+let stripeInstance: Stripe | null = null;
+
+export const getStripe = (): Stripe => {
+  const apiKey = process.env.STRIPE_SECRET_KEY;
+  if (!apiKey) {
+    throw new Error('STRIPE_SECRET_KEY is not configured');
+  }
+
+  if (!stripeInstance) {
+    stripeInstance = new Stripe(apiKey, {
+      apiVersion: '2025-11-17.clover',
+    });
+  }
+
+  return stripeInstance;
+};
 
 // Helper function to validate webhook signature
 export const validateStripeWebhook = (
@@ -12,7 +24,7 @@ export const validateStripeWebhook = (
   signature: string,
   secret: string
 ): Stripe.Event => {
-  return stripe.webhooks.constructEvent(payload, signature, secret);
+  return getStripe().webhooks.constructEvent(payload, signature, secret);
 };
 
 export interface BasicCheckoutSessionParams {
@@ -95,7 +107,7 @@ export const createCheckoutSession = async (
   const logId = await Apilogger.logStripeOutgoing('createCheckoutSession', params);
 
   try {
-    const session = await stripe.checkout.sessions.create(sessionParams);
+    const session = await getStripe().checkout.sessions.create(sessionParams);
 
     // Update log record with response
     Apilogger.updateResponse(logId, {
@@ -116,7 +128,7 @@ export const createCheckoutSession = async (
 
 // 根据发票ID去查支付ID
 export const fetchPaymentId = async (invoiceId: string ): Promise<string> => {
-  const fullInvoice = await stripe.invoices.retrieve(invoiceId, {
+  const fullInvoice = await getStripe().invoices.retrieve(invoiceId, {
     expand: ['payments']
   });
   const payment = fullInvoice.payments?.data[0];
@@ -147,7 +159,7 @@ export const createOrGetCustomer = async (params: {
 
   if (user.stripeCusId) {
     try {
-      const customer = await stripe.customers.retrieve(user.stripeCusId);
+      const customer = await getStripe().customers.retrieve(user.stripeCusId);
       if ('deleted' in customer) {
         await setStripeCustomerId(null);
       } else {
@@ -164,7 +176,7 @@ export const createOrGetCustomer = async (params: {
   }
 
   if (user.email) {
-    const existingCustomers = await stripe.customers.list({
+    const existingCustomers = await getStripe().customers.list({
       email: user.email,
       limit: 1,
     });
@@ -201,7 +213,7 @@ export const createOrGetCustomer = async (params: {
   });
   
   try {
-    const customer = await stripe.customers.create(customerParams);
+    const customer = await getStripe().customers.create(customerParams);
     await setStripeCustomerId(customer.id);
     
     // Update log record with response
@@ -228,13 +240,13 @@ export const updateSubscription = async (params: {
 }): Promise<Stripe.Subscription> => {
   const { subscriptionId, priceId, prorationBehavior = 'create_prorations' } = params;
 
-  const subscription = await stripe.subscriptions.retrieve(subscriptionId);
+  const subscription = await getStripe().subscriptions.retrieve(subscriptionId);
   
   // Create log record with request
   const logId = await Apilogger.logStripeOutgoing('updateSubscription', params);
   
   try {
-    const updatedSubscription = await stripe.subscriptions.update(subscriptionId, {
+    const updatedSubscription = await getStripe().subscriptions.update(subscriptionId, {
       items: [
         {
           id: subscription.items.data[0].id,
@@ -267,7 +279,7 @@ export const createCustomerPortalSession = async (params: {
   const logId = await Apilogger.logStripeOutgoing('createCustomerPortalSession', params);
 
   try {
-    const session = await stripe.billingPortal.sessions.create({
+    const session = await getStripe().billingPortal.sessions.create({
       customer: params.customerId,
       return_url: params.returnUrl,
     });
@@ -301,11 +313,11 @@ export const cancelSubscription = async (
     let result: Stripe.Subscription;
     
     if (cancelAtPeriodEnd) {
-      result = await stripe.subscriptions.update(subscriptionId, {
+      result = await getStripe().subscriptions.update(subscriptionId, {
         cancel_at_period_end: true,
       });
     } else {
-      result = await stripe.subscriptions.cancel(subscriptionId);
+      result = await getStripe().subscriptions.cancel(subscriptionId);
     }
     
     // Update log record with response

package/src/services/stripe/webhook-handler.ts

@@ -13,7 +13,7 @@ import {
 import { Transaction } from '@/db/prisma-model-type';
 import { oneTimeExpiredDays } from '@/lib/credit-init';
 import { getCreditsFromPriceId } from '@/lib/money-price-config';
-import { fetchPaymentId, stripe } from '@/lib/stripe-config';
+import { fetchPaymentId, getStripe } from '@/lib/stripe-config';
 import Stripe from 'stripe';
 import { viewLocalTime } from '@windrun-huaiin/lib/utils';
 
@@ -150,6 +150,7 @@ async function handleSubscriptionCheckoutInit(
   }
 
   const subscriptionId = session.subscription as string;
+  const stripe = getStripe();
 
   // ===== STEP 1: FETCH EXTERNAL API DATA (BEFORE TRANSACTION) =====
   // 2. Get COMPLETE Stripe subscription details including billing period
@@ -416,6 +417,7 @@ async function handleSubscriptionDeleted(stripeSubscription: Stripe.Subscription
 
 async function handleAsyncPaymentSucceeded(session: Stripe.Checkout.Session) {
   console.log(`Async payment succeeded: ${session.id}`);
+  const stripe = getStripe();
 
   // Retrieve the latest session state to ensure payment_status is up to date
   const latestSession = await stripe.checkout.sessions.retrieve(session.id);