From afa98768dc1e02809d5ec6bfa563fd49861bb5fb Mon Sep 17 00:00:00 2001
From: hustcc <xiaowei.wzw@antgroup.com>
Date: Tue, 14 Jul 2026 21:23:22 +0800
Subject: [PATCH] feat: add referer data

---
 README.md      | 6 +++---
 package.json   | 2 +-
 src/tracker.ts | 5 +++--
 src/utils.ts   | 4 ++--
 4 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 8366111..c79ad14 100644
--- a/README.md
+++ b/README.md
@@ -86,7 +86,7 @@ WFTK.init({
     "data": {
       "url": "https://example.com/page",
       "title": "Page Title",
-      "referrer": "https://google.com",
+      "referer": "https://google.com",
       "sessionId": "sess_xxx",
       "sessionStart": 1699999000000,
       "visitCount": 1,
@@ -112,13 +112,13 @@ Content-Type: application/json
 
 ### App Identification
 
-Primary method: use the `appId` from request body. Optional alternative: identify by request origin (Referrer/Host).
+Primary method: use the `appId` from request body. Optional alternative: identify by request origin (Referer/Host).
 
 ```javascript
 // Method 1: From request body (recommended)
 const appId = req.body.appId;
 
-// Method 2: By Referrer
+// Method 2: By Referer
 const domain = new URL(req.headers.referer || '').hostname;
 const appId = await getAppIdByDomain(domain);
 ```
diff --git a/package.json b/package.json
index c30706c..c17b8a7 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@weavefox/tracker",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Website Analytics SDK - Lightweight, secure tracking with anti-bot protection",
   "main": "dist/tracer.umd.js",
   "module": "dist/tracer.mjs",
diff --git a/src/tracker.ts b/src/tracker.ts
index bec46df..0b4dfc1 100644
--- a/src/tracker.ts
+++ b/src/tracker.ts
@@ -13,7 +13,7 @@ import {
 import {
   getTimestamp,
   generateNonce,
-  getReferrer,
+  getReferer,
   getTitle,
   getPageUrl,
   getViewport,
@@ -230,7 +230,8 @@ export class Tracer {
       // 页面信息
       url: getPageUrl(),
       title: getTitle(),
-      referrer: getReferrer(),
+      referer: getReferer(),
+      referrer: getReferer(), // 冗余传输
 
       // 会话信息
       sessionId: this.session.id,
diff --git a/src/utils.ts b/src/utils.ts
index e82d48f..96b3c3d 100644
--- a/src/utils.ts
+++ b/src/utils.ts
@@ -22,9 +22,9 @@ export function getTimestamp(): number {
 }
 
 /**
- * 获取页面 Referrer
+ * 获取页面 Referer
  */
-export function getReferrer(): string {
+export function getReferer(): string {
   return document.referrer || '';
 }