promo-tracker 0.0.0-stage → 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,190 @@
1
- # Temporary Holding Version
1
+ # promo-tracker
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ 基于 TypeScript 的浏览器追踪库,提供 Google Ads 参数保存、推广落地归因、Cookie 读取和浏览器 visitorId 获取功能,无 Nuxt/Vue 依赖。公共 API 以 [src/index.ts](src/index.ts) 的导出为准。
4
+
5
+ ## 安装依赖
6
+
7
+ 使用方需要安装以下 peer dependencies;构建产物不包含这两个库:
8
+
9
+ ```sh
10
+ npm install tldts@^7.5.4 @fingerprintjs/fingerprintjs@^5.3.0
11
+ ```
12
+
13
+ ## 公共导出
14
+
15
+ | 导出 | 说明 |
16
+ | --- | --- |
17
+ | `getGclid` | 读取 Google Ads 点击 ID |
18
+ | `getGoogleAdsParams` | 读取已保存的 Google Ads 落地页查询参数 |
19
+ | `persistGoogleAdsParams` | 保存 Google Ads 点击 ID 和查询参数 |
20
+ | `getCookie` | 按名称读取并解码 Cookie |
21
+ | `getVisitorId` | 获取浏览器 visitorId,成功后仅缓存在内存中 |
22
+ | `createPromoTracker` | 创建推广落地追踪实例 |
23
+ | `PromoParams` | 推广参数类型 |
24
+ | `ReportOptions` | 包含可选 `utmSource` 的类型,当前追踪实例没有接收此类型的方法 |
25
+ | `PromoTrackerOptions` | 推广追踪实例配置类型 |
26
+ | `PromoTracker` | `createPromoTracker` 返回值类型 |
27
+
28
+ ## Google Ads 参数
29
+
30
+ ```ts
31
+ import { getGclid, getGoogleAdsParams, persistGoogleAdsParams } from 'promo-tracker'
32
+
33
+ persistGoogleAdsParams()
34
+ const gclid = getGclid()
35
+ const params = getGoogleAdsParams()
36
+
37
+ // 使用当前页面和 document,将 Cookie 有效期设为 7 天。
38
+ persistGoogleAdsParams(undefined, undefined, 7 * 24 * 60 * 60)
39
+ ```
40
+
41
+ ### `persistGoogleAdsParams(url?, store?, cookieMaxAge?): void`
42
+
43
+ | 参数 | 类型 | 默认值 |
44
+ | --- | --- | --- |
45
+ | `url` | `URL` | 根据 `location.href` 创建 |
46
+ | `store` | `Pick<Document, 'cookie'>` | `document` |
47
+ | `cookieMaxAge` | `number` | `90 * 24 * 60 * 60`,单位为秒 |
48
+
49
+ URL 包含非空 `gclid` 时,写入 `_tracker_gclid` 和 `_tracker_google_ads_query` 两个 Cookie。没有 `gclid` 或值为空时跳过,不覆盖已有归因。
50
+
51
+ `gclid` 按 URL 解析后的值原样保存,不校验格式、不限制长度、不去除空白。查询参数 Cookie 保存该落地页的全部查询参数,包括 UTM 和业务自定义参数;同名参数保留最后一个值。
52
+
53
+ ```ts
54
+ persistGoogleAdsParams(
55
+ new URL('https://example.com/?gclid=click-123&utm_source=google'),
56
+ document,
57
+ 30 * 24 * 60 * 60,
58
+ )
59
+ ```
60
+
61
+ ### `getGclid(cookies?): string`
62
+
63
+ 默认从 `document.cookie` 读取 `_tracker_gclid`,也可显式传入 Cookie 字符串。缺失或解码失败时返回 `''`。
64
+
65
+ ### `getGoogleAdsParams(cookies?): Record<string, string>`
66
+
67
+ 默认从 `document.cookie` 读取 `_tracker_google_ads_query`,也可显式传入 Cookie 字符串。缺失、解码失败、JSON 无效或内容不是字符串值组成的对象时返回 `{}`。
68
+
69
+ ## Cookie 工具
70
+
71
+ ```ts
72
+ import { getCookie } from 'promo-tracker'
73
+
74
+ const value = getCookie('custom_cookie')
75
+ const explicitValue = getCookie('custom_cookie', 'custom_cookie=hello%20world')
76
+ ```
77
+
78
+ `getCookie(name: string, cookies?: string): string` 默认读取 `document.cookie`,按完整名称匹配并使用 `decodeURIComponent` 解码。缺失或解码失败时返回 `''`。
79
+
80
+ 库写入的 Cookie 使用 `_tracker` 命名空间,根据 `tldts` 解析结果设置父域;无可用父域时省略 Domain。统一设置 `Path=/`、`SameSite=Lax`,HTTPS 下设置 `Secure`。Cookie 访问被禁用时,读写操作会跳过或返回空值。
81
+
82
+ ## 浏览器 visitorId
83
+
84
+ ```ts
85
+ import { getVisitorId } from 'promo-tracker'
86
+
87
+ try {
88
+ const visitorId = await getVisitorId()
89
+ console.log(visitorId)
90
+ } catch (error) {
91
+ console.error('获取 visitorId 失败', error)
92
+ }
93
+ ```
94
+
95
+ `getVisitorId(): Promise<string>` 按需初始化 FingerprintJS,关闭使用统计,返回 `visitorId`。
96
+
97
+ 成功结果仅缓存在模块内存中,后续调用直接复用;并发调用共享同一次获取过程,刷新页面后重新获取。不读写 localStorage 或 Cookie。获取失败或结果为空时抛出异常,并清除失败缓存,允许下次重试。SSR 环境返回 `''`。
98
+
99
+ ## 推广落地追踪
100
+
101
+ ```ts
102
+ import { createPromoTracker } from 'promo-tracker'
103
+ import type { PromoTrackerOptions } from 'promo-tracker'
104
+
105
+ const options: PromoTrackerOptions = {
106
+ baseURL: 'https://product.example.com',
107
+ apiPath: '/web-api/zw/promo-event',
108
+ cookieMaxAge: 30 * 24 * 60 * 60,
109
+ }
110
+ const tracker = createPromoTracker(options)
111
+
112
+ const params = tracker.getPromoParams()
113
+ const utmSource = tracker.getUtmSource()
114
+ const traceId = await tracker.trackLanding()
115
+ const savedTraceId = tracker.getTraceId()
116
+
117
+ // 也可在不触发上报时,显式保存推广参数。
118
+ tracker.persistPromoParams(params)
119
+ ```
120
+
121
+ 创建实例不会自动发请求,建议每个页面复用一个实例。
122
+
123
+ ### 配置
124
+
125
+ | 配置 | 类型 | 默认值 | 说明 |
126
+ | --- | --- | --- | --- |
127
+ | `baseURL` | `string` | `''` | API 基础地址,默认当前站点,支持相对路径 |
128
+ | `apiPath` | `string` | `/web-api/zw/promo-event` | 相对 `baseURL` 的上报路径 |
129
+ | `cookieMaxAge` | `number` | `30 * 24 * 60 * 60` | 推广 Cookie 有效期,单位为秒 |
130
+
131
+ ### 实例方法
132
+
133
+ | 方法 | 返回值 | 行为 |
134
+ | --- | --- | --- |
135
+ | `trackLanding()` | `Promise<string \| null>` | 上报推广落地事件,返回 traceId;跳过或失败时返回 `null` |
136
+ | `getTraceId()` | `string \| null` | 优先从 localStorage 或实例内存读取 traceId,再尝试 Cookie |
137
+ | `getPromoParams()` | `PromoParams` | 从当前 URL 读取非空的推广参数 |
138
+ | `getUtmSource()` | `string \| undefined` | 返回当前 URL 中非空的 `utm_source` |
139
+ | `persistPromoParams(params?)` | `void` | 保存非空推广参数到 Cookie,默认使用当前 URL 的参数 |
140
+
141
+ `PromoParams` 包含三个可选字符串字段:`promoLinkId`、`inviteCode`、`utm_source`。
142
+
143
+ ### 落地上报规则
144
+
145
+ `trackLanding()` 在 URL 包含非空 `inviteCode` 时,向 `{baseURL}/{apiPath}/track` 发送 JSON POST。`promoLinkId` 缺失或无法转换为有限数字时使用 `1`。
146
+
147
+ 请求包含事件 ID、设备 ID、邀请码、UTM 来源、推广链接 ID、来源页面、当前页面和客户端时间,其中 `eventType` 为 `landing`,`eventTarget` 为 `promo_landing`。跨域调用需要服务端配置 CORS。
148
+
149
+ HTTP 响应必须成功,业务响应格式需为:
150
+
151
+ ```json
152
+ { "code": 0, "data": { "promoTraceId": "trace-123" } }
153
+ ```
154
+
155
+ 同一实例中,相同 `promoLinkId` 和 `inviteCode` 的并发请求合并;与最近成功保存的归因相同且已有 traceId 时不再请求,失败可重试。仅最新发起请求的响应可以更新保存的归因,避免较早响应覆盖较新结果。
156
+
157
+ 设备 ID 在内部优先复用已保存值,首次通过 `getVisitorId()` 生成,指纹获取失败时回退到 UUID。
158
+
159
+ ### 存储
160
+
161
+ | 存储位置 | Key | 内容 |
162
+ | --- | --- | --- |
163
+ | localStorage | `_tracker_promo_device_id` | 设备 ID |
164
+ | localStorage | `_tracker_promo_trace_id` | 最近保存的 traceId |
165
+ | localStorage | `_tracker_promo_attribution` | 最近成功保存的推广来源与 traceId |
166
+ | Cookie | `_tracker_promo_trace_id` | traceId |
167
+ | Cookie | `_tracker_promo_query` | 非空推广参数的 JSON 对象 |
168
+
169
+ 两个推广 Cookie 的有效期由 `cookieMaxAge` 控制;localStorage 不设置过期时间。localStorage 不可用时,在当前实例的内存中保留状态,刷新页面后可能重新上报。
170
+
171
+ 非浏览器环境可安全创建实例:`trackLanding()` 和 `getTraceId()` 返回 `null`,`getPromoParams()` 返回 `{}`,`getUtmSource()` 返回 `undefined`,保存操作跳过。
172
+
173
+ ## 开发与构建
174
+
175
+ ```sh
176
+ npm install
177
+ npm run dev
178
+ npm run typecheck
179
+ npm run build
180
+ ```
181
+
182
+ `index.html` 为本地调试入口。`npm test` 执行构建及 `tests/*.test.mjs` 中的测试。
183
+
184
+ | 构建产物 | 用途 |
185
+ | --- | --- |
186
+ | `dist/ad-tracker.js` | ESM |
187
+ | `dist/ad-tracker.umd.cjs` | UMD / CommonJS |
188
+ | `dist/index.d.ts` | TypeScript 类型入口 |
189
+
190
+ 普通 script 使用 UMD 时,先加载两个依赖的浏览器构建,提供全局变量 `tldts` 和 `FingerprintJS`,再加载 `ad-tracker.umd.cjs`。通过全局 `AdTracker` 访问运行时导出,例如 `AdTracker.createPromoTracker()`。
@@ -0,0 +1,6 @@
1
+ export declare function getGclid(cookies?: string): string;
2
+ export declare function getGoogleAdsParams(cookies?: string): Record<string, string>;
3
+ export declare function persistGoogleAdsParams(url?: URL | undefined, store?: Pick<Document, 'cookie'> | undefined,
4
+ /** Cookie 有效期,单位为秒;默认 90 天。 */
5
+ cookieMaxAge?: number): void;
6
+ //# sourceMappingURL=google-ads.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"google-ads.d.ts","sourceRoot":"","sources":["../src/google-ads.ts"],"names":[],"mappings":"AAOA,wBAAgB,QAAQ,CACtB,OAAO,GAAE,MAA4B,GACpC,MAAM,CAER;AAED,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,MAA4B,GACpC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWxB;AAED,wBAAgB,sBAAsB,CACpC,GAAG,GAAE,GAAG,GAAG,SAAgF,EAC3F,KAAK,GAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,SAAkE;AACpG,+BAA+B;AAC/B,YAAY,GAAE,MAAkC,GAC/C,IAAI,CAUN"}
@@ -0,0 +1,6 @@
1
+ export { getGclid, getGoogleAdsParams, persistGoogleAdsParams, } from './google-ads';
2
+ export { getCookie } from './utils/cookie';
3
+ export { getVisitorId } from './utils/visitor-id';
4
+ export { createPromoTracker } from './promo-tracker';
5
+ export type { PromoParams, ReportOptions, PromoTrackerOptions, PromoTracker } from './promo-tracker';
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA"}
@@ -0,0 +1,25 @@
1
+ export interface PromoParams {
2
+ promoLinkId?: string;
3
+ inviteCode?: string;
4
+ utm_source?: string;
5
+ }
6
+ export interface ReportOptions {
7
+ utmSource?: string;
8
+ }
9
+ export interface PromoTrackerOptions {
10
+ /** Cookie 有效期,单位为秒;默认 30 天。 */
11
+ cookieMaxAge?: number;
12
+ /** API 和产品页面的基础地址;默认当前站点,支持相对路径。 */
13
+ baseURL?: string;
14
+ /** 相对 baseURL 的上报路径。 */
15
+ apiPath?: string;
16
+ }
17
+ /** 创建独立的推广追踪实例,无 Nuxt/Vue 依赖;初始化不触发请求。 */
18
+ export declare function createPromoTracker(options?: PromoTrackerOptions): {
19
+ trackLanding: () => Promise<string | null>;
20
+ getTraceId: () => string | null;
21
+ getPromoParams: () => PromoParams;
22
+ getUtmSource: () => string | undefined;
23
+ };
24
+ export type PromoTracker = ReturnType<typeof createPromoTracker>;
25
+ //# sourceMappingURL=promo-tracker.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"promo-tracker.d.ts","sourceRoot":"","sources":["../src/promo-tracker.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAoBD,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB;wBAwFnC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;sBAtC9B,MAAM,GAAG,IAAI;0BAWT,WAAW;wBAWb,MAAM,GAAG,SAAS;EA6E5C;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA"}
@@ -0,0 +1,194 @@
1
+ import { getDomain as e } from "tldts";
2
+ import t from "@fingerprintjs/fingerprintjs";
3
+ // src/utils/cookie.ts
4
+ function n() {
5
+ try {
6
+ return typeof document > "u" ? "" : document.cookie;
7
+ } catch {
8
+ return "";
9
+ }
10
+ }
11
+ function r(e, t = n()) {
12
+ let r = `${e}=`, i = t.split(";").find((e) => e.trim().startsWith(r));
13
+ if (!i) return "";
14
+ try {
15
+ return decodeURIComponent(i.trim().slice(r.length));
16
+ } catch {
17
+ return "";
18
+ }
19
+ }
20
+ function i(t, n, r) {
21
+ try {
22
+ let i = r.store ?? (typeof document > "u" ? void 0 : document), a = r.url ?? (typeof window > "u" ? void 0 : new URL(window.location.href));
23
+ if (!i || !a) return;
24
+ let o = e(a.hostname, { allowPrivateDomains: !0 });
25
+ i.cookie = [
26
+ `${t}=${encodeURIComponent(n)}`,
27
+ ...o ? [`Domain=${o}`] : [],
28
+ "Path=/",
29
+ `Max-Age=${r.maxAge}`,
30
+ "SameSite=Lax",
31
+ ...a.protocol === "https:" ? ["Secure"] : []
32
+ ].join("; ");
33
+ } catch {}
34
+ }
35
+ // src/google-ads.ts
36
+ var a = "_tracker", o = `${a}_gclid`, s = `${a}_google_ads_query`, c = 7776e3;
37
+ function l(e = n()) {
38
+ return r(o, e);
39
+ }
40
+ function u(e = n()) {
41
+ let t = r(s, e);
42
+ if (!t) return {};
43
+ try {
44
+ let e = JSON.parse(t);
45
+ return typeof e != "object" || !e || Array.isArray(e) || !Object.values(e).every((e) => typeof e == "string") ? {} : e;
46
+ } catch {
47
+ return {};
48
+ }
49
+ }
50
+ function d(e = typeof location > "u" ? void 0 : new URL(location.href), t = typeof document > "u" ? void 0 : document, n = c) {
51
+ if (!e || !t) return;
52
+ let r = e.searchParams.get("gclid");
53
+ if (!r) return;
54
+ let a = {
55
+ url: e,
56
+ store: t,
57
+ maxAge: n
58
+ }, l = JSON.stringify(Object.fromEntries(e.searchParams));
59
+ i(o, r, a), i(s, l, a);
60
+ }
61
+ // src/utils/visitor-id.ts
62
+ var f;
63
+ async function p() {
64
+ return typeof window > "u" || typeof document > "u" ? "" : (f ||= (async () => {
65
+ let { visitorId: e } = await (await t.load({ monitoring: !1 })).get();
66
+ if (!e) throw Error("FingerprintJS returned an empty visitorId");
67
+ return e;
68
+ })().catch((e) => {
69
+ throw f = void 0, e;
70
+ }), f);
71
+ }
72
+ // src/promo-tracker.ts
73
+ var m = "/web-api/zw/promo-event", h = "_tracker", g = `${h}_promo_device_id`, _ = `${h}_promo_trace_id`, v = `${h}_promo_attribution`, y = `${h}_promo_query`, b = [
74
+ "promoLinkId",
75
+ "inviteCode",
76
+ "utm_source"
77
+ ];
78
+ function x(e, t) {
79
+ return `${e.replace(/\/+$/, "")}/${t.replace(/^\/+/, "")}`;
80
+ }
81
+ function S() {
82
+ if (typeof crypto.randomUUID == "function") return crypto.randomUUID();
83
+ let e = crypto.getRandomValues(/* @__PURE__ */ new Uint8Array(16));
84
+ e[6] = e[6] & 15 | 64, e[8] = e[8] & 63 | 128;
85
+ let t = Array.from(e, (e) => e.toString(16).padStart(2, "0")).join("");
86
+ return `${t.slice(0, 8)}-${t.slice(8, 12)}-${t.slice(12, 16)}-${t.slice(16, 20)}-${t.slice(20)}`;
87
+ }
88
+ function C(e = {}) {
89
+ let t = e.cookieMaxAge ?? 2592e3, n = x(e.baseURL ?? "", e.apiPath ?? m).replace(/\/+$/, ""), a = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map(), s = 0, c;
90
+ function l() {
91
+ return typeof window < "u" && typeof document < "u";
92
+ }
93
+ function u(e) {
94
+ try {
95
+ return window.localStorage.getItem(e) ?? a.get(e) ?? null;
96
+ } catch {
97
+ return a.get(e) ?? null;
98
+ }
99
+ }
100
+ function d(e, t) {
101
+ a.set(e, t);
102
+ try {
103
+ window.localStorage.setItem(e, t);
104
+ } catch {}
105
+ }
106
+ async function f() {
107
+ return l() ? u(g) || (c ||= (async () => {
108
+ let e;
109
+ try {
110
+ e = await p();
111
+ } catch {
112
+ e = S();
113
+ }
114
+ return d(g, e), e;
115
+ })(), c) : "";
116
+ }
117
+ function h() {
118
+ return l() && (u(_) || r(_)) || null;
119
+ }
120
+ function C(e) {
121
+ l() && e && (d(_, e), i(_, e, { maxAge: t }));
122
+ }
123
+ function w() {
124
+ let e = {};
125
+ if (!l()) return e;
126
+ let t = new URL(window.location.href).searchParams;
127
+ for (let n of b) {
128
+ let r = t.get(n);
129
+ r && (e[n] = r);
130
+ }
131
+ return e;
132
+ }
133
+ function T() {
134
+ return w().utm_source;
135
+ }
136
+ function E(e = w()) {
137
+ if (!l()) return;
138
+ let n = b.flatMap((t) => e[t] ? [[t, e[t]]] : []);
139
+ n.length && i(y, JSON.stringify(Object.fromEntries(n)), { maxAge: t });
140
+ }
141
+ function D(e) {
142
+ return JSON.stringify([e.promoLinkId || "", e.inviteCode || ""]);
143
+ }
144
+ async function O() {
145
+ if (!l()) return null;
146
+ let e = w();
147
+ if (!e.inviteCode) return null;
148
+ let t = D(e), r = h();
149
+ if (r && u(v) === JSON.stringify([t, r])) return r;
150
+ let i = o.get(t);
151
+ if (i) return i;
152
+ let a = ++s, c = window.location.href, p = document.referrer || void 0, m = (async () => {
153
+ try {
154
+ E(e);
155
+ let r = Number(e.promoLinkId || 1), i = await fetch(`${n}/track`, {
156
+ method: "POST",
157
+ headers: { "Content-Type": "application/json" },
158
+ body: JSON.stringify({
159
+ eventId: S(),
160
+ deviceId: await f(),
161
+ inviteCode: e.inviteCode,
162
+ utmSource: e.utm_source,
163
+ promoLinkId: Number.isFinite(r) ? r : 1,
164
+ eventType: "landing",
165
+ eventTarget: "promo_landing",
166
+ referrer: p,
167
+ pageUrl: c,
168
+ clientTime: Date.now()
169
+ })
170
+ });
171
+ if (!i.ok) return null;
172
+ let o = await i.json(), l = o?.data?.promoTraceId;
173
+ return o?.code !== 0 || typeof l != "string" || !l ? null : (a === s && (C(l), d(v, JSON.stringify([t, l]))), l);
174
+ } catch {
175
+ return null;
176
+ }
177
+ })();
178
+ o.set(t, m);
179
+ try {
180
+ return await m;
181
+ } finally {
182
+ o.delete(t);
183
+ }
184
+ }
185
+ return {
186
+ trackLanding: O,
187
+ getTraceId: h,
188
+ getPromoParams: w,
189
+ getUtmSource: T
190
+ };
191
+ }
192
+ export { C as createPromoTracker, r as getCookie, l as getGclid, u as getGoogleAdsParams, p as getVisitorId, d as persistGoogleAdsParams };
193
+
194
+ //# sourceMappingURL=promo-tracker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"promo-tracker.js","names":["FingerprintJS","getBrowserCookies","getCookie","prefix","name","entry","cookies","cookie","setCookie","store","options","url","domain","getDomain","value","COOKIE_NAMESPACE","GCLID_COOKIE_NAME","GOOGLE_ADS_QUERY_COOKIE_NAME","GOOGLE_ADS_COOKIE_MAX_AGE","getGclid","getGoogleAdsParams","queryParams","params","persistGoogleAdsParams","gclid","cookieMaxAge","visitorIdPromise","getVisitorId","visitorId","error","PROMO_API_PATH","STORAGE_NAMESPACE","DEVICE_ID","TRACE_ID","ATTRIBUTION","COOKIE_PARAMS","PROMO_PARAM_KEYS","joinPath","base","path","createId","bytes","hex","byte","createPromoTracker","apiBase","memory","pending","latestRequest","deviceIdPromise","isClient","readStorage","key","writeStorage","getDeviceId","id","getTraceId","saveTraceId","getPromoParams","search","getUtmSource","persistPromoParams","entries","attributionKey","trackLanding","traceId","existing","requestId","pageUrl","referrer","request","linkId","response","result"],"sources":["../src/utils/cookie.ts","../src/google-ads.ts","../src/utils/visitor-id.ts","../src/promo-tracker.ts"],"sourcesContent":["import { getDomain } from 'tldts'\n\ninterface CookieOptions {\n /** Cookie 有效期,单位为秒。 */\n maxAge: number\n url?: URL\n store?: Pick<Document, 'cookie'>\n}\n\nexport function getBrowserCookies(): string {\n try {\n return typeof document === 'undefined' ? '' : document.cookie\n } catch {\n return ''\n }\n}\n\nexport function getCookie(name: string, cookies: string = getBrowserCookies()): string {\n const prefix = `${name}=`\n const entry = cookies.split(';').find(cookie => cookie.trim().startsWith(prefix))\n if (!entry) return ''\n try {\n return decodeURIComponent(entry.trim().slice(prefix.length))\n } catch {\n return ''\n }\n}\n\n/** 写入父域 Cookie;缺少浏览器上下文或访问被禁止时跳过。 */\nexport function setCookie(name: string, value: string, options: CookieOptions): void {\n try {\n const store = options.store ?? (typeof document === 'undefined' ? undefined : document)\n const url = options.url ?? (typeof window === 'undefined' ? undefined : new URL(window.location.href))\n if (!store || !url) return\n\n const domain = getDomain(url.hostname, { allowPrivateDomains: true })\n store.cookie = [\n `${name}=${encodeURIComponent(value)}`,\n ...(domain ? [`Domain=${domain}`] : []),\n 'Path=/',\n `Max-Age=${options.maxAge}`,\n 'SameSite=Lax',\n ...(url.protocol === 'https:' ? ['Secure'] : []),\n ].join('; ')\n } catch {\n // Cookie 被禁用时不影响业务逻辑。\n }\n}\n","import { getBrowserCookies, getCookie, setCookie } from './utils/cookie'\n\nconst COOKIE_NAMESPACE = '_tracker'\nconst GCLID_COOKIE_NAME = `${COOKIE_NAMESPACE}_gclid`\nconst GOOGLE_ADS_QUERY_COOKIE_NAME = `${COOKIE_NAMESPACE}_google_ads_query`\nconst GOOGLE_ADS_COOKIE_MAX_AGE = 90 * 24 * 60 * 60\n\nexport function getGclid(\n cookies: string = getBrowserCookies(),\n): string {\n return getCookie(GCLID_COOKIE_NAME, cookies)\n}\n\nexport function getGoogleAdsParams(\n cookies: string = getBrowserCookies(),\n): Record<string, string> {\n const queryParams = getCookie(GOOGLE_ADS_QUERY_COOKIE_NAME, cookies)\n if (!queryParams) return {}\n try {\n const params: unknown = JSON.parse(queryParams)\n if (typeof params !== 'object' || params === null || Array.isArray(params)) return {}\n if (!Object.values(params).every(value => typeof value === 'string')) return {}\n return params as Record<string, string>\n } catch {\n return {}\n }\n}\n\nexport function persistGoogleAdsParams(\n url: URL | undefined = typeof location === 'undefined' ? undefined : new URL(location.href),\n store: Pick<Document, 'cookie'> | undefined = typeof document === 'undefined' ? undefined : document,\n /** Cookie 有效期,单位为秒;默认 90 天。 */\n cookieMaxAge: number = GOOGLE_ADS_COOKIE_MAX_AGE,\n): void {\n if (!url || !store) return\n\n const gclid = url.searchParams.get('gclid')\n if (!gclid) return\n\n const options = { url, store, maxAge: cookieMaxAge }\n const queryParams = JSON.stringify(Object.fromEntries(url.searchParams))\n setCookie(GCLID_COOKIE_NAME, gclid, options)\n setCookie(GOOGLE_ADS_QUERY_COOKIE_NAME, queryParams, options)\n}\n","import FingerprintJS from '@fingerprintjs/fingerprintjs'\n\nlet visitorIdPromise: Promise<string> | undefined\n\n/** 成功获取后始终复用缓存;失败不缓存,下次调用可重试。SSR 返回空字符串。 */\nexport async function getVisitorId(): Promise<string> {\n if (typeof window === 'undefined' || typeof document === 'undefined') return ''\n if (!visitorIdPromise) {\n visitorIdPromise = (async () => {\n const agent = await FingerprintJS.load({ monitoring: false })\n const { visitorId } = await agent.get()\n if (!visitorId) throw new Error('FingerprintJS returned an empty visitorId')\n return visitorId\n })().catch(error => {\n visitorIdPromise = undefined\n throw error\n })\n }\n return visitorIdPromise\n}\n","import { getCookie, setCookie } from './utils/cookie'\nimport { getVisitorId } from './utils/visitor-id'\n\nconst PROMO_API_PATH = '/web-api/zw/promo-event'\nconst STORAGE_NAMESPACE = '_tracker'\nconst DEVICE_ID = `${STORAGE_NAMESPACE}_promo_device_id`\nconst TRACE_ID = `${STORAGE_NAMESPACE}_promo_trace_id`\nconst ATTRIBUTION = `${STORAGE_NAMESPACE}_promo_attribution`\nconst COOKIE_PARAMS = `${STORAGE_NAMESPACE}_promo_query`\nconst PROMO_PARAM_KEYS = ['promoLinkId', 'inviteCode', 'utm_source'] as const\n\nexport interface PromoParams {\n promoLinkId?: string\n inviteCode?: string\n utm_source?: string\n}\n\nexport interface ReportOptions {\n utmSource?: string\n}\n\nexport interface PromoTrackerOptions {\n /** Cookie 有效期,单位为秒;默认 30 天。 */\n cookieMaxAge?: number\n /** API 和产品页面的基础地址;默认当前站点,支持相对路径。 */\n baseURL?: string\n /** 相对 baseURL 的上报路径。 */\n apiPath?: string\n}\n\ninterface TrackResponse {\n code: number\n data?: { promoTraceId?: string } | null\n}\n\nfunction joinPath(base: string, path: string): string {\n return `${base.replace(/\\/+$/, '')}/${path.replace(/^\\/+/, '')}`\n}\n\nfunction createId(): string {\n if (typeof crypto.randomUUID === 'function') return crypto.randomUUID()\n const bytes = crypto.getRandomValues(new Uint8Array(16))\n bytes[6] = (bytes[6] & 0x0f) | 0x40\n bytes[8] = (bytes[8] & 0x3f) | 0x80\n const hex = Array.from(bytes, byte => byte.toString(16).padStart(2, '0')).join('')\n return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`\n}\n\n/** 创建独立的推广追踪实例,无 Nuxt/Vue 依赖;初始化不触发请求。 */\nexport function createPromoTracker(options: PromoTrackerOptions = {}) {\n const cookieMaxAge = options.cookieMaxAge ?? 30 * 24 * 60 * 60\n const baseURL = options.baseURL ?? ''\n const apiBase = joinPath(baseURL, options.apiPath ?? PROMO_API_PATH).replace(/\\/+$/, '')\n const memory = new Map<string, string>()\n const pending = new Map<string, Promise<string | null>>()\n let latestRequest = 0\n let deviceIdPromise: Promise<string> | undefined\n\n function isClient(): boolean {\n return typeof window !== 'undefined' && typeof document !== 'undefined'\n }\n\n function readStorage(key: string): string | null {\n try {\n return window.localStorage.getItem(key) ?? memory.get(key) ?? null\n } catch {\n return memory.get(key) ?? null\n }\n }\n\n function writeStorage(key: string, value: string): void {\n memory.set(key, value)\n try {\n window.localStorage.setItem(key, value)\n } catch {\n // 存储被禁用时,在当前实例内保留状态。\n }\n }\n\n /** 优先复用已保存的 ID,否则生成浏览器指纹;失败时回退到 UUID。 */\n async function getDeviceId(): Promise<string> {\n if (!isClient()) return ''\n const existing = readStorage(DEVICE_ID)\n if (existing) return existing\n if (!deviceIdPromise) {\n deviceIdPromise = (async () => {\n let id: string\n try {\n id = await getVisitorId()\n } catch {\n id = createId()\n }\n writeStorage(DEVICE_ID, id)\n return id\n })()\n }\n return deviceIdPromise\n }\n\n function getTraceId(): string | null {\n if (!isClient()) return null\n return readStorage(TRACE_ID) || getCookie(TRACE_ID) || null\n }\n\n function saveTraceId(id: string): void {\n if (!isClient() || !id) return\n writeStorage(TRACE_ID, id)\n setCookie(TRACE_ID, id, { maxAge: cookieMaxAge })\n }\n\n function getPromoParams(): PromoParams {\n const params: PromoParams = {}\n if (!isClient()) return params\n const search = new URL(window.location.href).searchParams\n for (const key of PROMO_PARAM_KEYS) {\n const value = search.get(key)\n if (value) params[key] = value\n }\n return params\n }\n\n function getUtmSource(): string | undefined {\n return getPromoParams().utm_source\n }\n\n function persistPromoParams(params: PromoParams = getPromoParams()): void {\n if (!isClient()) return\n const entries = PROMO_PARAM_KEYS.flatMap(key => params[key] ? [[key, params[key]]] : [])\n if (entries.length) {\n setCookie(COOKIE_PARAMS, JSON.stringify(Object.fromEntries(entries)), { maxAge: cookieMaxAge })\n }\n }\n\n function attributionKey(params: PromoParams): string {\n return JSON.stringify([params.promoLinkId || '', params.inviteCode || ''])\n }\n\n async function trackLanding(): Promise<string | null> {\n if (!isClient()) return null\n const params = getPromoParams()\n if (!params.inviteCode) return null\n const key = attributionKey(params)\n const traceId = getTraceId()\n if (traceId && readStorage(ATTRIBUTION) === JSON.stringify([key, traceId])) return traceId\n const existing = pending.get(key)\n if (existing) return existing\n\n const requestId = ++latestRequest\n const pageUrl = window.location.href\n const referrer = document.referrer || undefined\n const request = (async (): Promise<string | null> => {\n try {\n persistPromoParams(params)\n const linkId = Number(params.promoLinkId || 1)\n const response = await fetch(`${apiBase}/track`, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n eventId: createId(),\n deviceId: await getDeviceId(),\n inviteCode: params.inviteCode,\n utmSource: params.utm_source,\n promoLinkId: Number.isFinite(linkId) ? linkId : 1,\n eventType: 'landing',\n eventTarget: 'promo_landing',\n referrer,\n pageUrl,\n clientTime: Date.now(),\n }),\n })\n if (!response.ok) return null\n const result: TrackResponse = await response.json()\n const id = result?.data?.promoTraceId\n if (result?.code !== 0 || typeof id !== 'string' || !id) return null\n // 较早请求的响应不能覆盖后来访问的推广链接。\n if (requestId === latestRequest) {\n saveTraceId(id)\n writeStorage(ATTRIBUTION, JSON.stringify([key, id]))\n }\n return id\n } catch {\n return null\n }\n })()\n pending.set(key, request)\n try {\n return await request\n } finally {\n pending.delete(key)\n }\n }\n\n return {\n trackLanding,\n getTraceId, \n getPromoParams, \n getUtmSource\n }\n}\n\nexport type PromoTracker = ReturnType<typeof createPromoTracker>\n"],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ (function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("tldts"),require("@fingerprintjs/fingerprintjs")):typeof define==`function`&&define.amd?define([`exports`,`tldts`,`@fingerprintjs/fingerprintjs`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.PromoTracker={},e.tldts,e.FingerprintJS))})(this,function(e,t,n){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var r=Object.create,i=Object.defineProperty,a=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,s=Object.getPrototypeOf,c=Object.prototype.hasOwnProperty,l=(e,t,n,r)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var s=o(t),l=0,u=s.length,d;l<u;l++)d=s[l],!c.call(e,d)&&d!==n&&i(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(r=a(t,d))||r.enumerable});return e};n=((e,t,n)=>(n=e==null?{}:r(s(e)),l(i(n,`default`,{value:e,enumerable:!0}),e)))(n,1);function u(){try{return typeof document>`u`?``:document.cookie}catch{return``}}function d(e,t=u()){let n=`${e}=`,r=t.split(`;`).find(e=>e.trim().startsWith(n));if(!r)return``;try{return decodeURIComponent(r.trim().slice(n.length))}catch{return``}}function f(e,n,r){try{let i=r.store??(typeof document>`u`?void 0:document),a=r.url??(typeof window>`u`?void 0:new URL(window.location.href));if(!i||!a)return;let o=(0,t.getDomain)(a.hostname,{allowPrivateDomains:!0});i.cookie=[`${e}=${encodeURIComponent(n)}`,...o?[`Domain=${o}`]:[],`Path=/`,`Max-Age=${r.maxAge}`,`SameSite=Lax`,...a.protocol===`https:`?[`Secure`]:[]].join(`; `)}catch{}}var p=`_tracker`,m=`${p}_gclid`,h=`${p}_google_ads_query`,g=7776e3;function _(e=u()){return d(m,e)}function v(e=u()){let t=d(h,e);if(!t)return{};try{let e=JSON.parse(t);return typeof e!=`object`||!e||Array.isArray(e)||!Object.values(e).every(e=>typeof e==`string`)?{}:e}catch{return{}}}function y(e=typeof location>`u`?void 0:new URL(location.href),t=typeof document>`u`?void 0:document,n=g){if(!e||!t)return;let r=e.searchParams.get(`gclid`);if(!r)return;let i={url:e,store:t,maxAge:n},a=JSON.stringify(Object.fromEntries(e.searchParams));f(m,r,i),f(h,a,i)}var b;async function x(){return typeof window>`u`||typeof document>`u`?``:(b||=(async()=>{let{visitorId:e}=await(await n.default.load({monitoring:!1})).get();if(!e)throw Error(`FingerprintJS returned an empty visitorId`);return e})().catch(e=>{throw b=void 0,e}),b)}var S=`/web-api/zw/promo-event`,C=`_tracker`,w=`${C}_promo_device_id`,T=`${C}_promo_trace_id`,E=`${C}_promo_attribution`,D=`${C}_promo_query`,O=[`promoLinkId`,`inviteCode`,`utm_source`];function k(e,t){return`${e.replace(/\/+$/,``)}/${t.replace(/^\/+/,``)}`}function A(){if(typeof crypto.randomUUID==`function`)return crypto.randomUUID();let e=crypto.getRandomValues(new Uint8Array(16));e[6]=e[6]&15|64,e[8]=e[8]&63|128;let t=Array.from(e,e=>e.toString(16).padStart(2,`0`)).join(``);return`${t.slice(0,8)}-${t.slice(8,12)}-${t.slice(12,16)}-${t.slice(16,20)}-${t.slice(20)}`}function j(e={}){let t=e.cookieMaxAge??2592e3,n=k(e.baseURL??``,e.apiPath??S).replace(/\/+$/,``),r=new Map,i=new Map,a=0,o;function s(){return typeof window<`u`&&typeof document<`u`}function c(e){try{return window.localStorage.getItem(e)??r.get(e)??null}catch{return r.get(e)??null}}function l(e,t){r.set(e,t);try{window.localStorage.setItem(e,t)}catch{}}async function u(){return s()?c(w)||(o||=(async()=>{let e;try{e=await x()}catch{e=A()}return l(w,e),e})(),o):``}function p(){return s()&&(c(T)||d(T))||null}function m(e){s()&&e&&(l(T,e),f(T,e,{maxAge:t}))}function h(){let e={};if(!s())return e;let t=new URL(window.location.href).searchParams;for(let n of O){let r=t.get(n);r&&(e[n]=r)}return e}function g(){return h().utm_source}function _(e=h()){if(!s())return;let n=O.flatMap(t=>e[t]?[[t,e[t]]]:[]);n.length&&f(D,JSON.stringify(Object.fromEntries(n)),{maxAge:t})}function v(e){return JSON.stringify([e.promoLinkId||``,e.inviteCode||``])}async function y(){if(!s())return null;let e=h();if(!e.inviteCode)return null;let t=v(e),r=p();if(r&&c(E)===JSON.stringify([t,r]))return r;let o=i.get(t);if(o)return o;let d=++a,f=window.location.href,g=document.referrer||void 0,y=(async()=>{try{_(e);let r=Number(e.promoLinkId||1),i=await fetch(`${n}/track`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({eventId:A(),deviceId:await u(),inviteCode:e.inviteCode,utmSource:e.utm_source,promoLinkId:Number.isFinite(r)?r:1,eventType:`landing`,eventTarget:`promo_landing`,referrer:g,pageUrl:f,clientTime:Date.now()})});if(!i.ok)return null;let o=await i.json(),s=o?.data?.promoTraceId;return o?.code!==0||typeof s!=`string`||!s?null:(d===a&&(m(s),l(E,JSON.stringify([t,s]))),s)}catch{return null}})();i.set(t,y);try{return await y}finally{i.delete(t)}}return{trackLanding:y,getTraceId:p,getPromoParams:h,getUtmSource:g}}e.createPromoTracker=j,e.getCookie=d,e.getGclid=_,e.getGoogleAdsParams=v,e.getVisitorId=x,e.persistGoogleAdsParams=y});
2
+ //# sourceMappingURL=promo-tracker.umd.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"promo-tracker.umd.cjs","names":["getDomain","FingerprintJS","factory","global","exports","__create","__defProp","__getOwnPropDesc","__getOwnPropNames","__getProtoOf","__hasOwnProp","__copyProps","from","keys","i","n","key","to","except","k","desc","mod","target","_fingerprintjs_fingerprintjs","getBrowserCookies","getCookie","prefix","name","entry","cookies","cookie","setCookie","store","options","url","domain","tldts","value","COOKIE_NAMESPACE","GCLID_COOKIE_NAME","GOOGLE_ADS_QUERY_COOKIE_NAME","GOOGLE_ADS_COOKIE_MAX_AGE","getGclid","getGoogleAdsParams","queryParams","params","persistGoogleAdsParams","gclid","cookieMaxAge","visitorIdPromise","getVisitorId","visitorId","error","PROMO_API_PATH","STORAGE_NAMESPACE","DEVICE_ID","TRACE_ID","ATTRIBUTION","COOKIE_PARAMS","PROMO_PARAM_KEYS","joinPath","base","path","createId","bytes","hex","byte","createPromoTracker","apiBase","memory","pending","latestRequest","deviceIdPromise","isClient","readStorage","writeStorage","getDeviceId","id","getTraceId","saveTraceId","getPromoParams","search","getUtmSource","persistPromoParams","entries","attributionKey","trackLanding","traceId","existing","requestId","pageUrl","referrer","request","linkId","response","result"],"sources":["../src/utils/cookie.ts","../src/google-ads.ts","../src/utils/visitor-id.ts","../src/promo-tracker.ts"],"sourcesContent":["import { getDomain } from 'tldts'\n\ninterface CookieOptions {\n /** Cookie 有效期,单位为秒。 */\n maxAge: number\n url?: URL\n store?: Pick<Document, 'cookie'>\n}\n\nexport function getBrowserCookies(): string {\n try {\n return typeof document === 'undefined' ? '' : document.cookie\n } catch {\n return ''\n }\n}\n\nexport function getCookie(name: string, cookies: string = getBrowserCookies()): string {\n const prefix = `${name}=`\n const entry = cookies.split(';').find(cookie => cookie.trim().startsWith(prefix))\n if (!entry) return ''\n try {\n return decodeURIComponent(entry.trim().slice(prefix.length))\n } catch {\n return ''\n }\n}\n\n/** 写入父域 Cookie;缺少浏览器上下文或访问被禁止时跳过。 */\nexport function setCookie(name: string, value: string, options: CookieOptions): void {\n try {\n const store = options.store ?? (typeof document === 'undefined' ? undefined : document)\n const url = options.url ?? (typeof window === 'undefined' ? undefined : new URL(window.location.href))\n if (!store || !url) return\n\n const domain = getDomain(url.hostname, { allowPrivateDomains: true })\n store.cookie = [\n `${name}=${encodeURIComponent(value)}`,\n ...(domain ? [`Domain=${domain}`] : []),\n 'Path=/',\n `Max-Age=${options.maxAge}`,\n 'SameSite=Lax',\n ...(url.protocol === 'https:' ? ['Secure'] : []),\n ].join('; ')\n } catch {\n // Cookie 被禁用时不影响业务逻辑。\n }\n}\n","import { getBrowserCookies, getCookie, setCookie } from './utils/cookie'\n\nconst COOKIE_NAMESPACE = '_tracker'\nconst GCLID_COOKIE_NAME = `${COOKIE_NAMESPACE}_gclid`\nconst GOOGLE_ADS_QUERY_COOKIE_NAME = `${COOKIE_NAMESPACE}_google_ads_query`\nconst GOOGLE_ADS_COOKIE_MAX_AGE = 90 * 24 * 60 * 60\n\nexport function getGclid(\n cookies: string = getBrowserCookies(),\n): string {\n return getCookie(GCLID_COOKIE_NAME, cookies)\n}\n\nexport function getGoogleAdsParams(\n cookies: string = getBrowserCookies(),\n): Record<string, string> {\n const queryParams = getCookie(GOOGLE_ADS_QUERY_COOKIE_NAME, cookies)\n if (!queryParams) return {}\n try {\n const params: unknown = JSON.parse(queryParams)\n if (typeof params !== 'object' || params === null || Array.isArray(params)) return {}\n if (!Object.values(params).every(value => typeof value === 'string')) return {}\n return params as Record<string, string>\n } catch {\n return {}\n }\n}\n\nexport function persistGoogleAdsParams(\n url: URL | undefined = typeof location === 'undefined' ? undefined : new URL(location.href),\n store: Pick<Document, 'cookie'> | undefined = typeof document === 'undefined' ? undefined : document,\n /** Cookie 有效期,单位为秒;默认 90 天。 */\n cookieMaxAge: number = GOOGLE_ADS_COOKIE_MAX_AGE,\n): void {\n if (!url || !store) return\n\n const gclid = url.searchParams.get('gclid')\n if (!gclid) return\n\n const options = { url, store, maxAge: cookieMaxAge }\n const queryParams = JSON.stringify(Object.fromEntries(url.searchParams))\n setCookie(GCLID_COOKIE_NAME, gclid, options)\n setCookie(GOOGLE_ADS_QUERY_COOKIE_NAME, queryParams, options)\n}\n","import FingerprintJS from '@fingerprintjs/fingerprintjs'\n\nlet visitorIdPromise: Promise<string> | undefined\n\n/** 成功获取后始终复用缓存;失败不缓存,下次调用可重试。SSR 返回空字符串。 */\nexport async function getVisitorId(): Promise<string> {\n if (typeof window === 'undefined' || typeof document === 'undefined') return ''\n if (!visitorIdPromise) {\n visitorIdPromise = (async () => {\n const agent = await FingerprintJS.load({ monitoring: false })\n const { visitorId } = await agent.get()\n if (!visitorId) throw new Error('FingerprintJS returned an empty visitorId')\n return visitorId\n })().catch(error => {\n visitorIdPromise = undefined\n throw error\n })\n }\n return visitorIdPromise\n}\n","import { getCookie, setCookie } from './utils/cookie'\nimport { getVisitorId } from './utils/visitor-id'\n\nconst PROMO_API_PATH = '/web-api/zw/promo-event'\nconst STORAGE_NAMESPACE = '_tracker'\nconst DEVICE_ID = `${STORAGE_NAMESPACE}_promo_device_id`\nconst TRACE_ID = `${STORAGE_NAMESPACE}_promo_trace_id`\nconst ATTRIBUTION = `${STORAGE_NAMESPACE}_promo_attribution`\nconst COOKIE_PARAMS = `${STORAGE_NAMESPACE}_promo_query`\nconst PROMO_PARAM_KEYS = ['promoLinkId', 'inviteCode', 'utm_source'] as const\n\nexport interface PromoParams {\n promoLinkId?: string\n inviteCode?: string\n utm_source?: string\n}\n\nexport interface ReportOptions {\n utmSource?: string\n}\n\nexport interface PromoTrackerOptions {\n /** Cookie 有效期,单位为秒;默认 30 天。 */\n cookieMaxAge?: number\n /** API 和产品页面的基础地址;默认当前站点,支持相对路径。 */\n baseURL?: string\n /** 相对 baseURL 的上报路径。 */\n apiPath?: string\n}\n\ninterface TrackResponse {\n code: number\n data?: { promoTraceId?: string } | null\n}\n\nfunction joinPath(base: string, path: string): string {\n return `${base.replace(/\\/+$/, '')}/${path.replace(/^\\/+/, '')}`\n}\n\nfunction createId(): string {\n if (typeof crypto.randomUUID === 'function') return crypto.randomUUID()\n const bytes = crypto.getRandomValues(new Uint8Array(16))\n bytes[6] = (bytes[6] & 0x0f) | 0x40\n bytes[8] = (bytes[8] & 0x3f) | 0x80\n const hex = Array.from(bytes, byte => byte.toString(16).padStart(2, '0')).join('')\n return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`\n}\n\n/** 创建独立的推广追踪实例,无 Nuxt/Vue 依赖;初始化不触发请求。 */\nexport function createPromoTracker(options: PromoTrackerOptions = {}) {\n const cookieMaxAge = options.cookieMaxAge ?? 30 * 24 * 60 * 60\n const baseURL = options.baseURL ?? ''\n const apiBase = joinPath(baseURL, options.apiPath ?? PROMO_API_PATH).replace(/\\/+$/, '')\n const memory = new Map<string, string>()\n const pending = new Map<string, Promise<string | null>>()\n let latestRequest = 0\n let deviceIdPromise: Promise<string> | undefined\n\n function isClient(): boolean {\n return typeof window !== 'undefined' && typeof document !== 'undefined'\n }\n\n function readStorage(key: string): string | null {\n try {\n return window.localStorage.getItem(key) ?? memory.get(key) ?? null\n } catch {\n return memory.get(key) ?? null\n }\n }\n\n function writeStorage(key: string, value: string): void {\n memory.set(key, value)\n try {\n window.localStorage.setItem(key, value)\n } catch {\n // 存储被禁用时,在当前实例内保留状态。\n }\n }\n\n /** 优先复用已保存的 ID,否则生成浏览器指纹;失败时回退到 UUID。 */\n async function getDeviceId(): Promise<string> {\n if (!isClient()) return ''\n const existing = readStorage(DEVICE_ID)\n if (existing) return existing\n if (!deviceIdPromise) {\n deviceIdPromise = (async () => {\n let id: string\n try {\n id = await getVisitorId()\n } catch {\n id = createId()\n }\n writeStorage(DEVICE_ID, id)\n return id\n })()\n }\n return deviceIdPromise\n }\n\n function getTraceId(): string | null {\n if (!isClient()) return null\n return readStorage(TRACE_ID) || getCookie(TRACE_ID) || null\n }\n\n function saveTraceId(id: string): void {\n if (!isClient() || !id) return\n writeStorage(TRACE_ID, id)\n setCookie(TRACE_ID, id, { maxAge: cookieMaxAge })\n }\n\n function getPromoParams(): PromoParams {\n const params: PromoParams = {}\n if (!isClient()) return params\n const search = new URL(window.location.href).searchParams\n for (const key of PROMO_PARAM_KEYS) {\n const value = search.get(key)\n if (value) params[key] = value\n }\n return params\n }\n\n function getUtmSource(): string | undefined {\n return getPromoParams().utm_source\n }\n\n function persistPromoParams(params: PromoParams = getPromoParams()): void {\n if (!isClient()) return\n const entries = PROMO_PARAM_KEYS.flatMap(key => params[key] ? [[key, params[key]]] : [])\n if (entries.length) {\n setCookie(COOKIE_PARAMS, JSON.stringify(Object.fromEntries(entries)), { maxAge: cookieMaxAge })\n }\n }\n\n function attributionKey(params: PromoParams): string {\n return JSON.stringify([params.promoLinkId || '', params.inviteCode || ''])\n }\n\n async function trackLanding(): Promise<string | null> {\n if (!isClient()) return null\n const params = getPromoParams()\n if (!params.inviteCode) return null\n const key = attributionKey(params)\n const traceId = getTraceId()\n if (traceId && readStorage(ATTRIBUTION) === JSON.stringify([key, traceId])) return traceId\n const existing = pending.get(key)\n if (existing) return existing\n\n const requestId = ++latestRequest\n const pageUrl = window.location.href\n const referrer = document.referrer || undefined\n const request = (async (): Promise<string | null> => {\n try {\n persistPromoParams(params)\n const linkId = Number(params.promoLinkId || 1)\n const response = await fetch(`${apiBase}/track`, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n eventId: createId(),\n deviceId: await getDeviceId(),\n inviteCode: params.inviteCode,\n utmSource: params.utm_source,\n promoLinkId: Number.isFinite(linkId) ? linkId : 1,\n eventType: 'landing',\n eventTarget: 'promo_landing',\n referrer,\n pageUrl,\n clientTime: Date.now(),\n }),\n })\n if (!response.ok) return null\n const result: TrackResponse = await response.json()\n const id = result?.data?.promoTraceId\n if (result?.code !== 0 || typeof id !== 'string' || !id) return null\n // 较早请求的响应不能覆盖后来访问的推广链接。\n if (requestId === latestRequest) {\n saveTraceId(id)\n writeStorage(ATTRIBUTION, JSON.stringify([key, id]))\n }\n return id\n } catch {\n return null\n }\n })()\n pending.set(key, request)\n try {\n return await request\n } finally {\n pending.delete(key)\n }\n }\n\n return {\n trackLanding,\n getTraceId, \n getPromoParams, \n getUtmSource\n }\n}\n\nexport type PromoTracker = ReturnType<typeof createPromoTracker>\n"],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ interface CookieOptions {
2
+ /** Cookie 有效期,单位为秒。 */
3
+ maxAge: number;
4
+ url?: URL;
5
+ store?: Pick<Document, 'cookie'>;
6
+ }
7
+ export declare function getBrowserCookies(): string;
8
+ export declare function getCookie(name: string, cookies?: string): string;
9
+ /** 写入父域 Cookie;缺少浏览器上下文或访问被禁止时跳过。 */
10
+ export declare function setCookie(name: string, value: string, options: CookieOptions): void;
11
+ export {};
12
+ //# sourceMappingURL=cookie.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../src/utils/cookie.ts"],"names":[],"mappings":"AAEA,UAAU,aAAa;IACrB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,GAAG,CAAA;IACT,KAAK,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;CACjC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAA4B,GAAG,MAAM,CASrF;AAED,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAkBnF"}
@@ -0,0 +1,3 @@
1
+ /** 成功获取后始终复用缓存;失败不缓存,下次调用可重试。SSR 返回空字符串。 */
2
+ export declare function getVisitorId(): Promise<string>;
3
+ //# sourceMappingURL=visitor-id.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"visitor-id.d.ts","sourceRoot":"","sources":["../../src/utils/visitor-id.ts"],"names":[],"mappings":"AAIA,4CAA4C;AAC5C,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAcpD"}
package/package.json CHANGED
@@ -1,6 +1,36 @@
1
1
  {
2
2
  "name": "promo-tracker",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.0.1",
4
+ "private": false,
5
+ "type": "module",
6
+ "files": [
7
+ "dist"
8
+ ],
9
+ "main": "./dist/promo-tracker.umd.cjs",
10
+ "module": "./dist/promo-tracker.js",
11
+ "types": "./dist/index.d.ts",
12
+ "exports": {
13
+ ".": {
14
+ "types": "./dist/index.d.ts",
15
+ "import": "./dist/promo-tracker.js",
16
+ "require": "./dist/promo-tracker.umd.cjs"
17
+ }
18
+ },
19
+ "scripts": {
20
+ "dev": "vite",
21
+ "typecheck": "tsc --noEmit",
22
+ "test": "npm run build && node --test tests/*.test.mjs",
23
+ "build": "npm run typecheck && vite build && tsc --emitDeclarationOnly",
24
+ "build:watch": "vite build --watch"
25
+ },
26
+ "devDependencies": {
27
+ "@fingerprintjs/fingerprintjs": "^5.3.0",
28
+ "tldts": "^7.5.4",
29
+ "typescript": "~5.9.3",
30
+ "vite": "^8.0.0"
31
+ },
32
+ "peerDependencies": {
33
+ "@fingerprintjs/fingerprintjs": "^5.3.0",
34
+ "tldts": "^7.5.4"
35
+ }
6
36
  }