giime 1.1.6-snapshot.1 → 1.1.6
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/es/giime/version.d.ts +1 -1
- package/es/giime/version.mjs +1 -1
- package/es/giime/version.mjs.map +1 -1
- package/es/track/src/adapters/html.d.ts +3 -3
- package/es/track/src/core/session.d.ts +2 -2
- package/es/track/src/core/tracker.d.ts +1 -0
- package/es/track/src/types/index.d.ts +15 -11
- package/es/track/src/utils/browser.d.ts +1 -1
- package/es/track/src/utils/env.d.ts +18 -10
- package/lib/giime/version.d.ts +1 -1
- package/lib/giime/version.js +1 -1
- package/lib/giime/version.js.map +1 -1
- package/lib/track/src/adapters/html.d.ts +3 -3
- package/lib/track/src/core/session.d.ts +2 -2
- package/lib/track/src/core/tracker.d.ts +1 -0
- package/lib/track/src/types/index.d.ts +15 -11
- package/lib/track/src/utils/browser.d.ts +1 -1
- package/lib/track/src/utils/env.d.ts +18 -10
- package/package.json +1 -1
package/es/giime/version.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const version = "1.1.6
|
|
1
|
+
export declare const version = "1.1.6";
|
package/es/giime/version.mjs
CHANGED
package/es/giime/version.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"version.mjs","sources":["../../../../packages/giime/version.ts"],"sourcesContent":["export const version = '1.1.6
|
|
1
|
+
{"version":3,"file":"version.mjs","sources":["../../../../packages/giime/version.ts"],"sourcesContent":["export const version = '1.1.6';\n"],"names":[],"mappings":"AAAO,MAAM,OAAA,GAAU;;;;"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @file 商城多页 HTML (
|
|
2
|
+
* @file 商城多页 HTML (商城端 ShopPlus) 适配器与非侵入式双轨并行代理 (@giime/track/html)
|
|
3
3
|
* @description 100% 兼容商城存量 102 个埋点事件,支持新老 SDK 任意加载顺序零冲突共存
|
|
4
4
|
*/
|
|
5
5
|
import type { GiimeTracker } from '../core/tracker';
|
|
@@ -11,8 +11,8 @@ import type { GiimeTrackConfig } from '../types';
|
|
|
11
11
|
export declare const attachShopPlusDualTrackProxy: (tracker: GiimeTracker) => void;
|
|
12
12
|
/**
|
|
13
13
|
* 初始化 HTML 多页模式埋点 SDK
|
|
14
|
-
* -
|
|
15
|
-
* -
|
|
14
|
+
* - 默认值全部为商城端模式(appType: 'shop', source: 'plus', env: 'prod')
|
|
15
|
+
* - 也支持管理端 (manage) 的 HTML 项目使用:传入 data-app-type="manage" 或 initHtmlTrack({ appType: 'manage' }) 即可切换
|
|
16
16
|
* @param customConfig 可选自定义配置
|
|
17
17
|
*/
|
|
18
18
|
export declare const initHtmlTrack: (customConfig?: GiimeTrackConfig) => GiimeTracker;
|
|
@@ -8,7 +8,7 @@ import type { GiimeTrackConfig, ShopPlusContext } from '../types';
|
|
|
8
8
|
export declare class TrackSessionManager {
|
|
9
9
|
private config;
|
|
10
10
|
private uid;
|
|
11
|
-
/** 连续访问会话标识(原 sessionId,30
|
|
11
|
+
/** 连续访问会话标识(原 sessionId,30分钟超时重建,商城端 shop 映射为 eid) */
|
|
12
12
|
private visitId;
|
|
13
13
|
/** 页面会话标识(原 pageId,每次进入或刷新页面生成新值) */
|
|
14
14
|
private sessionId;
|
|
@@ -93,7 +93,7 @@ export declare class TrackSessionManager {
|
|
|
93
93
|
*/
|
|
94
94
|
cutShopPlusEid(): void;
|
|
95
95
|
/**
|
|
96
|
-
* 解析来源标识 source(2026-10-23
|
|
96
|
+
* 解析来源标识 source(2026-10-23 评审会决议:商城端 shop 区分老单页 / ShopPlus / 三方 / Shopline / Shopify 等,管理端 manage 默认 '')
|
|
97
97
|
*/
|
|
98
98
|
resolveSource(): string;
|
|
99
99
|
/**
|
|
@@ -92,7 +92,7 @@ export interface BrowserContext {
|
|
|
92
92
|
};
|
|
93
93
|
}
|
|
94
94
|
/**
|
|
95
|
-
*
|
|
95
|
+
* 商城端(ShopPlus)专属上下文信息(100% 兼容 statistics.[hash].ts 的 getBase 字段)
|
|
96
96
|
*/
|
|
97
97
|
export interface ShopPlusContext {
|
|
98
98
|
/** 访客永久设备 ID (__sx_event_poster_uid) */
|
|
@@ -192,7 +192,7 @@ export interface PointerPathNode {
|
|
|
192
192
|
* 单条埋点事件完整契约结构(对齐 2026-10-23 数据契约评审会决议)
|
|
193
193
|
* - 外层请求体仅保留 { events: TrackEventRecord[] },所有批次与环境字段全部收拢在每条 Event 内
|
|
194
194
|
* - sessionId 代表单次进入/刷新页面的会话标识(原 pageId),preSessionId 代表上一页会话标识(原 prePageId)
|
|
195
|
-
* - visitId 代表跨页面的连续访问会话标识(30
|
|
195
|
+
* - visitId 代表跨页面的连续访问会话标识(30分钟超时重建,商城端 shop 映射为购物会话 eid)
|
|
196
196
|
*/
|
|
197
197
|
export interface TrackEventRecord<TPayload extends Record<string, any> = Record<string, any>> {
|
|
198
198
|
/** 事件唯一标识(重发时保持不变,由数据团队在入湖后去重) */
|
|
@@ -205,9 +205,9 @@ export interface TrackEventRecord<TPayload extends Record<string, any> = Record<
|
|
|
205
205
|
eventName: TrackEventName;
|
|
206
206
|
/** 事件实际发生时间(毫秒时间戳) */
|
|
207
207
|
eventTime: number;
|
|
208
|
-
/**
|
|
208
|
+
/** 用户标识:商城端 (shop) 直接上报访客 uid;管理端 (manage) 固定传空字符串,由后端接收接口层按登录态补充 */
|
|
209
209
|
userId: string;
|
|
210
|
-
/**
|
|
210
|
+
/** 来源标识:商城端 (shop) 区分 5 套商城体系(如 plus / single / third / shopline / shopify),管理端 (manage) 默认传空字符串 '' */
|
|
211
211
|
source: string;
|
|
212
212
|
/** 前端路由名称(纯粹取路由 route.name,商城 HTML 取 ShopPlus.router.pageId;必传字段,无路由时允许为空字符串 '') */
|
|
213
213
|
pageKey: string;
|
|
@@ -217,7 +217,7 @@ export interface TrackEventRecord<TPayload extends Record<string, any> = Record<
|
|
|
217
217
|
sessionId: string;
|
|
218
218
|
/** 上一页会话标识(原 prePageId,串联跨页面跳转链路,首次进入为空字符串 '') */
|
|
219
219
|
preSessionId: string;
|
|
220
|
-
/** 连续访问会话标识(原 sessionId,关联跨页面的连续访问,30
|
|
220
|
+
/** 连续访问会话标识(原 sessionId,关联跨页面的连续访问,30分钟超时重建;商城端 shop 映射为购物会话 eid) */
|
|
221
221
|
visitId: string;
|
|
222
222
|
/** 当前页面完整地址(已过滤敏感参数,供数据团队入湖后映射系统/模块/功能) */
|
|
223
223
|
url: string;
|
|
@@ -241,7 +241,7 @@ export interface TrackEventRecord<TPayload extends Record<string, any> = Record<
|
|
|
241
241
|
payload: TPayload;
|
|
242
242
|
/** 浏览器与设备环境指纹信息 */
|
|
243
243
|
browserContext: BrowserContext;
|
|
244
|
-
/**
|
|
244
|
+
/** 商城端 (shop) 专属上下文(管理端 manage 模式为 null) */
|
|
245
245
|
shopContext: ShopPlusContext | null;
|
|
246
246
|
}
|
|
247
247
|
/**
|
|
@@ -285,20 +285,24 @@ export interface GiimeTrackPluginOptions {
|
|
|
285
285
|
formAndCopy?: boolean;
|
|
286
286
|
/** 是否开启资源加载异常与 JS 运行时异常采集,默认 true */
|
|
287
287
|
error?: boolean;
|
|
288
|
-
/**
|
|
288
|
+
/** 在商城端 (shop) 模式下,是否开启对存量 window.statisticsPoster 的非侵入式双轨镜像代理,默认 true */
|
|
289
289
|
shopPlusDualTrackProxy?: boolean;
|
|
290
290
|
}
|
|
291
|
+
/**
|
|
292
|
+
* 业务端采集模式类型:manage(管理端) / shop(商城端)
|
|
293
|
+
*/
|
|
294
|
+
export type TrackAppType = 'manage' | 'shop';
|
|
291
295
|
/**
|
|
292
296
|
* SDK 初始化总配置项(所有字段均为可选,默认内置自动识别)
|
|
293
297
|
*/
|
|
294
298
|
export interface GiimeTrackConfig {
|
|
295
299
|
/** 环境变量对象(可傳 import.meta.env 或 process.env,不传则根据当前域名自动识别环境) */
|
|
296
300
|
env?: Record<string, any> | string;
|
|
297
|
-
/**
|
|
301
|
+
/** 接收服务接口地址(管理端 manage 默认 4 套环境 + '/guard/data-capture/ingest/v1/auth/track',商城端 shop 默认相对路径 '/ingest/v1/shop/track',一般无需传) */
|
|
298
302
|
endpoint?: string;
|
|
299
|
-
/** SDK 本地采集模式:
|
|
300
|
-
appType?:
|
|
301
|
-
/** 来源标识(2026-10-23
|
|
303
|
+
/** SDK 本地采集模式:manage(管理端) / shop(商城端),仅控制端侧行为,不随 JSON 上报;报文 appType 由后端按接收接口补充 */
|
|
304
|
+
appType?: TrackAppType;
|
|
305
|
+
/** 来源标识(2026-10-23 评审会新增:商城端 shop 区分 5 套商城体系如 'plus' | 'single' | 'third' | 'shopline' | 'shopify',管理端 manage 默认 '') */
|
|
302
306
|
source?: string;
|
|
303
307
|
/** 页面模板标识(商城多皮肤模板自动提取) */
|
|
304
308
|
templateId?: string;
|
|
@@ -56,9 +56,17 @@ export declare const TRACK_ENV_KEYS: {
|
|
|
56
56
|
*/
|
|
57
57
|
export declare const TRACK_ENV_CONFIGS: Record<string, TrackEnvConfig>;
|
|
58
58
|
/**
|
|
59
|
-
*
|
|
59
|
+
* 管理端(manage)默认采集接收服务相对路径(挂载在 /guard 网关下,自动享受 giimeDevProxyFn 的本地开发代理)
|
|
60
60
|
*/
|
|
61
|
-
export declare const
|
|
61
|
+
export declare const BUILTIN_MANAGE_TRACK_PATH = "/guard/data-capture/ingest/v1/auth/track";
|
|
62
|
+
/**
|
|
63
|
+
* 商城端(shop)默认采集接收服务相对路径(直接跟随商城当前访问域名请求相对路径,由同域名 Nginx + Lua 接收)
|
|
64
|
+
*/
|
|
65
|
+
export declare const BUILTIN_SHOP_TRACK_PATH = "/ingest/v1/shop/track";
|
|
66
|
+
/**
|
|
67
|
+
* 默认采集接收服务相对路径(兼容导出,等同于 BUILTIN_MANAGE_TRACK_PATH)
|
|
68
|
+
*/
|
|
69
|
+
export declare const BUILTIN_TRACK_PATH = "/guard/data-capture/ingest/v1/auth/track";
|
|
62
70
|
/**
|
|
63
71
|
* 拼接 URL 路径(对齐 @giime/utils/src/http/url.ts 的 urlJoin)
|
|
64
72
|
*/
|
|
@@ -68,15 +76,15 @@ export declare const joinTrackUrl: (base: string, path: string) => string;
|
|
|
68
76
|
*/
|
|
69
77
|
export declare const resolveTrackModeConfig: (mode?: string) => TrackEnvConfig | undefined;
|
|
70
78
|
/**
|
|
71
|
-
* 根据传入的 env (import.meta.env)
|
|
72
|
-
*
|
|
73
|
-
* 1.
|
|
74
|
-
* 2.
|
|
75
|
-
* 3.
|
|
76
|
-
* 4.
|
|
77
|
-
* 5.
|
|
79
|
+
* 根据传入的 env (import.meta.env)、自定义地址和业务端类型 (manage / shop),解析完整环境信息与最终采集接口地址
|
|
80
|
+
* 优先级:
|
|
81
|
+
* 1. 显式传入的 customEndpoint(或 script 标签 data-endpoint)
|
|
82
|
+
* 2. 环境变量显式指定 (VITE_GIIME_TRACK_URL / VITE_GIIME_TRACK_API)
|
|
83
|
+
* 3. 商城端模式 (appType === 'shop'):直接走相对路径 `/ingest/v1/shop/track`(跟随商城实际访问域名,严禁暴露吉客印域名)
|
|
84
|
+
* 4. 管理端本地开发 (env.DEV === true):走相对路径 `/guard/data-capture/ingest/v1/auth/track`(复用 vite.config.ts 中 giimeDevProxyFn 生成的 /guard 代理)
|
|
85
|
+
* 5. 管理端 4 套环境地址:按 VITE_GIIME_MODE 或当前浏览器 hostname 匹配对应环境域名并拼接 `/guard/data-capture/ingest/v1/auth/track`
|
|
78
86
|
*/
|
|
79
|
-
export declare const resolveTrackEnvironment: (envInput?: TrackEnvInput, customEndpoint?: string) => {
|
|
87
|
+
export declare const resolveTrackEnvironment: (envInput?: TrackEnvInput, customEndpoint?: string, appType?: 'manage' | 'shop') => {
|
|
80
88
|
envName: 'dev' | 'test' | 'release' | 'prod';
|
|
81
89
|
tenant: TrackTenantType;
|
|
82
90
|
endpoint: string;
|
package/lib/giime/version.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const version = "1.1.6
|
|
1
|
+
export declare const version = "1.1.6";
|
package/lib/giime/version.js
CHANGED
package/lib/giime/version.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"version.js","sources":["../../../../packages/giime/version.ts"],"sourcesContent":["export const version = '1.1.6
|
|
1
|
+
{"version":3,"file":"version.js","sources":["../../../../packages/giime/version.ts"],"sourcesContent":["export const version = '1.1.6';\n"],"names":[],"mappings":";;AAAO,MAAM,OAAA,GAAU;;;;"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @file 商城多页 HTML (
|
|
2
|
+
* @file 商城多页 HTML (商城端 ShopPlus) 适配器与非侵入式双轨并行代理 (@giime/track/html)
|
|
3
3
|
* @description 100% 兼容商城存量 102 个埋点事件,支持新老 SDK 任意加载顺序零冲突共存
|
|
4
4
|
*/
|
|
5
5
|
import type { GiimeTracker } from '../core/tracker';
|
|
@@ -11,8 +11,8 @@ import type { GiimeTrackConfig } from '../types';
|
|
|
11
11
|
export declare const attachShopPlusDualTrackProxy: (tracker: GiimeTracker) => void;
|
|
12
12
|
/**
|
|
13
13
|
* 初始化 HTML 多页模式埋点 SDK
|
|
14
|
-
* -
|
|
15
|
-
* -
|
|
14
|
+
* - 默认值全部为商城端模式(appType: 'shop', source: 'plus', env: 'prod')
|
|
15
|
+
* - 也支持管理端 (manage) 的 HTML 项目使用:传入 data-app-type="manage" 或 initHtmlTrack({ appType: 'manage' }) 即可切换
|
|
16
16
|
* @param customConfig 可选自定义配置
|
|
17
17
|
*/
|
|
18
18
|
export declare const initHtmlTrack: (customConfig?: GiimeTrackConfig) => GiimeTracker;
|
|
@@ -8,7 +8,7 @@ import type { GiimeTrackConfig, ShopPlusContext } from '../types';
|
|
|
8
8
|
export declare class TrackSessionManager {
|
|
9
9
|
private config;
|
|
10
10
|
private uid;
|
|
11
|
-
/** 连续访问会话标识(原 sessionId,30
|
|
11
|
+
/** 连续访问会话标识(原 sessionId,30分钟超时重建,商城端 shop 映射为 eid) */
|
|
12
12
|
private visitId;
|
|
13
13
|
/** 页面会话标识(原 pageId,每次进入或刷新页面生成新值) */
|
|
14
14
|
private sessionId;
|
|
@@ -93,7 +93,7 @@ export declare class TrackSessionManager {
|
|
|
93
93
|
*/
|
|
94
94
|
cutShopPlusEid(): void;
|
|
95
95
|
/**
|
|
96
|
-
* 解析来源标识 source(2026-10-23
|
|
96
|
+
* 解析来源标识 source(2026-10-23 评审会决议:商城端 shop 区分老单页 / ShopPlus / 三方 / Shopline / Shopify 等,管理端 manage 默认 '')
|
|
97
97
|
*/
|
|
98
98
|
resolveSource(): string;
|
|
99
99
|
/**
|
|
@@ -92,7 +92,7 @@ export interface BrowserContext {
|
|
|
92
92
|
};
|
|
93
93
|
}
|
|
94
94
|
/**
|
|
95
|
-
*
|
|
95
|
+
* 商城端(ShopPlus)专属上下文信息(100% 兼容 statistics.[hash].ts 的 getBase 字段)
|
|
96
96
|
*/
|
|
97
97
|
export interface ShopPlusContext {
|
|
98
98
|
/** 访客永久设备 ID (__sx_event_poster_uid) */
|
|
@@ -192,7 +192,7 @@ export interface PointerPathNode {
|
|
|
192
192
|
* 单条埋点事件完整契约结构(对齐 2026-10-23 数据契约评审会决议)
|
|
193
193
|
* - 外层请求体仅保留 { events: TrackEventRecord[] },所有批次与环境字段全部收拢在每条 Event 内
|
|
194
194
|
* - sessionId 代表单次进入/刷新页面的会话标识(原 pageId),preSessionId 代表上一页会话标识(原 prePageId)
|
|
195
|
-
* - visitId 代表跨页面的连续访问会话标识(30
|
|
195
|
+
* - visitId 代表跨页面的连续访问会话标识(30分钟超时重建,商城端 shop 映射为购物会话 eid)
|
|
196
196
|
*/
|
|
197
197
|
export interface TrackEventRecord<TPayload extends Record<string, any> = Record<string, any>> {
|
|
198
198
|
/** 事件唯一标识(重发时保持不变,由数据团队在入湖后去重) */
|
|
@@ -205,9 +205,9 @@ export interface TrackEventRecord<TPayload extends Record<string, any> = Record<
|
|
|
205
205
|
eventName: TrackEventName;
|
|
206
206
|
/** 事件实际发生时间(毫秒时间戳) */
|
|
207
207
|
eventTime: number;
|
|
208
|
-
/**
|
|
208
|
+
/** 用户标识:商城端 (shop) 直接上报访客 uid;管理端 (manage) 固定传空字符串,由后端接收接口层按登录态补充 */
|
|
209
209
|
userId: string;
|
|
210
|
-
/**
|
|
210
|
+
/** 来源标识:商城端 (shop) 区分 5 套商城体系(如 plus / single / third / shopline / shopify),管理端 (manage) 默认传空字符串 '' */
|
|
211
211
|
source: string;
|
|
212
212
|
/** 前端路由名称(纯粹取路由 route.name,商城 HTML 取 ShopPlus.router.pageId;必传字段,无路由时允许为空字符串 '') */
|
|
213
213
|
pageKey: string;
|
|
@@ -217,7 +217,7 @@ export interface TrackEventRecord<TPayload extends Record<string, any> = Record<
|
|
|
217
217
|
sessionId: string;
|
|
218
218
|
/** 上一页会话标识(原 prePageId,串联跨页面跳转链路,首次进入为空字符串 '') */
|
|
219
219
|
preSessionId: string;
|
|
220
|
-
/** 连续访问会话标识(原 sessionId,关联跨页面的连续访问,30
|
|
220
|
+
/** 连续访问会话标识(原 sessionId,关联跨页面的连续访问,30分钟超时重建;商城端 shop 映射为购物会话 eid) */
|
|
221
221
|
visitId: string;
|
|
222
222
|
/** 当前页面完整地址(已过滤敏感参数,供数据团队入湖后映射系统/模块/功能) */
|
|
223
223
|
url: string;
|
|
@@ -241,7 +241,7 @@ export interface TrackEventRecord<TPayload extends Record<string, any> = Record<
|
|
|
241
241
|
payload: TPayload;
|
|
242
242
|
/** 浏览器与设备环境指纹信息 */
|
|
243
243
|
browserContext: BrowserContext;
|
|
244
|
-
/**
|
|
244
|
+
/** 商城端 (shop) 专属上下文(管理端 manage 模式为 null) */
|
|
245
245
|
shopContext: ShopPlusContext | null;
|
|
246
246
|
}
|
|
247
247
|
/**
|
|
@@ -285,20 +285,24 @@ export interface GiimeTrackPluginOptions {
|
|
|
285
285
|
formAndCopy?: boolean;
|
|
286
286
|
/** 是否开启资源加载异常与 JS 运行时异常采集,默认 true */
|
|
287
287
|
error?: boolean;
|
|
288
|
-
/**
|
|
288
|
+
/** 在商城端 (shop) 模式下,是否开启对存量 window.statisticsPoster 的非侵入式双轨镜像代理,默认 true */
|
|
289
289
|
shopPlusDualTrackProxy?: boolean;
|
|
290
290
|
}
|
|
291
|
+
/**
|
|
292
|
+
* 业务端采集模式类型:manage(管理端) / shop(商城端)
|
|
293
|
+
*/
|
|
294
|
+
export type TrackAppType = 'manage' | 'shop';
|
|
291
295
|
/**
|
|
292
296
|
* SDK 初始化总配置项(所有字段均为可选,默认内置自动识别)
|
|
293
297
|
*/
|
|
294
298
|
export interface GiimeTrackConfig {
|
|
295
299
|
/** 环境变量对象(可傳 import.meta.env 或 process.env,不传则根据当前域名自动识别环境) */
|
|
296
300
|
env?: Record<string, any> | string;
|
|
297
|
-
/**
|
|
301
|
+
/** 接收服务接口地址(管理端 manage 默认 4 套环境 + '/guard/data-capture/ingest/v1/auth/track',商城端 shop 默认相对路径 '/ingest/v1/shop/track',一般无需传) */
|
|
298
302
|
endpoint?: string;
|
|
299
|
-
/** SDK 本地采集模式:
|
|
300
|
-
appType?:
|
|
301
|
-
/** 来源标识(2026-10-23
|
|
303
|
+
/** SDK 本地采集模式:manage(管理端) / shop(商城端),仅控制端侧行为,不随 JSON 上报;报文 appType 由后端按接收接口补充 */
|
|
304
|
+
appType?: TrackAppType;
|
|
305
|
+
/** 来源标识(2026-10-23 评审会新增:商城端 shop 区分 5 套商城体系如 'plus' | 'single' | 'third' | 'shopline' | 'shopify',管理端 manage 默认 '') */
|
|
302
306
|
source?: string;
|
|
303
307
|
/** 页面模板标识(商城多皮肤模板自动提取) */
|
|
304
308
|
templateId?: string;
|
|
@@ -56,9 +56,17 @@ export declare const TRACK_ENV_KEYS: {
|
|
|
56
56
|
*/
|
|
57
57
|
export declare const TRACK_ENV_CONFIGS: Record<string, TrackEnvConfig>;
|
|
58
58
|
/**
|
|
59
|
-
*
|
|
59
|
+
* 管理端(manage)默认采集接收服务相对路径(挂载在 /guard 网关下,自动享受 giimeDevProxyFn 的本地开发代理)
|
|
60
60
|
*/
|
|
61
|
-
export declare const
|
|
61
|
+
export declare const BUILTIN_MANAGE_TRACK_PATH = "/guard/data-capture/ingest/v1/auth/track";
|
|
62
|
+
/**
|
|
63
|
+
* 商城端(shop)默认采集接收服务相对路径(直接跟随商城当前访问域名请求相对路径,由同域名 Nginx + Lua 接收)
|
|
64
|
+
*/
|
|
65
|
+
export declare const BUILTIN_SHOP_TRACK_PATH = "/ingest/v1/shop/track";
|
|
66
|
+
/**
|
|
67
|
+
* 默认采集接收服务相对路径(兼容导出,等同于 BUILTIN_MANAGE_TRACK_PATH)
|
|
68
|
+
*/
|
|
69
|
+
export declare const BUILTIN_TRACK_PATH = "/guard/data-capture/ingest/v1/auth/track";
|
|
62
70
|
/**
|
|
63
71
|
* 拼接 URL 路径(对齐 @giime/utils/src/http/url.ts 的 urlJoin)
|
|
64
72
|
*/
|
|
@@ -68,15 +76,15 @@ export declare const joinTrackUrl: (base: string, path: string) => string;
|
|
|
68
76
|
*/
|
|
69
77
|
export declare const resolveTrackModeConfig: (mode?: string) => TrackEnvConfig | undefined;
|
|
70
78
|
/**
|
|
71
|
-
* 根据传入的 env (import.meta.env)
|
|
72
|
-
*
|
|
73
|
-
* 1.
|
|
74
|
-
* 2.
|
|
75
|
-
* 3.
|
|
76
|
-
* 4.
|
|
77
|
-
* 5.
|
|
79
|
+
* 根据传入的 env (import.meta.env)、自定义地址和业务端类型 (manage / shop),解析完整环境信息与最终采集接口地址
|
|
80
|
+
* 优先级:
|
|
81
|
+
* 1. 显式传入的 customEndpoint(或 script 标签 data-endpoint)
|
|
82
|
+
* 2. 环境变量显式指定 (VITE_GIIME_TRACK_URL / VITE_GIIME_TRACK_API)
|
|
83
|
+
* 3. 商城端模式 (appType === 'shop'):直接走相对路径 `/ingest/v1/shop/track`(跟随商城实际访问域名,严禁暴露吉客印域名)
|
|
84
|
+
* 4. 管理端本地开发 (env.DEV === true):走相对路径 `/guard/data-capture/ingest/v1/auth/track`(复用 vite.config.ts 中 giimeDevProxyFn 生成的 /guard 代理)
|
|
85
|
+
* 5. 管理端 4 套环境地址:按 VITE_GIIME_MODE 或当前浏览器 hostname 匹配对应环境域名并拼接 `/guard/data-capture/ingest/v1/auth/track`
|
|
78
86
|
*/
|
|
79
|
-
export declare const resolveTrackEnvironment: (envInput?: TrackEnvInput, customEndpoint?: string) => {
|
|
87
|
+
export declare const resolveTrackEnvironment: (envInput?: TrackEnvInput, customEndpoint?: string, appType?: 'manage' | 'shop') => {
|
|
80
88
|
envName: 'dev' | 'test' | 'release' | 'prod';
|
|
81
89
|
tenant: TrackTenantType;
|
|
82
90
|
endpoint: string;
|