@interfere/react 3.0.0 → 4.0.0
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/dist/error-boundary.d.mts +27 -0
- package/dist/error-boundary.d.mts.map +1 -0
- package/dist/error-boundary.mjs +44 -0
- package/dist/error-boundary.mjs.map +1 -0
- package/dist/internal/client.d.mts +34 -0
- package/dist/internal/client.d.mts.map +1 -0
- package/dist/internal/client.mjs +103 -0
- package/dist/internal/client.mjs.map +1 -0
- package/dist/internal/config.d.mts +9 -0
- package/dist/internal/config.d.mts.map +1 -0
- package/dist/internal/config.mjs +27 -0
- package/dist/internal/config.mjs.map +1 -0
- package/dist/internal/consent.d.mts +15 -0
- package/dist/internal/consent.d.mts.map +1 -0
- package/dist/internal/consent.mjs +25 -0
- package/dist/internal/consent.mjs.map +1 -0
- package/dist/internal/context.d.mts +6 -0
- package/dist/internal/context.d.mts.map +1 -0
- package/dist/internal/context.mjs +32 -0
- package/dist/internal/context.mjs.map +1 -0
- package/dist/internal/envelope.d.mts +14 -0
- package/dist/internal/envelope.d.mts.map +1 -0
- package/dist/internal/envelope.mjs +20 -0
- package/dist/internal/envelope.mjs.map +1 -0
- package/dist/internal/errors.d.mts +4 -0
- package/dist/internal/errors.d.mts.map +1 -0
- package/dist/internal/errors.mjs +4 -0
- package/dist/internal/errors.mjs.map +1 -0
- package/dist/internal/plugin-runtime.d.mts +26 -0
- package/dist/internal/plugin-runtime.d.mts.map +1 -0
- package/dist/internal/plugin-runtime.mjs +85 -0
- package/dist/internal/plugin-runtime.mjs.map +1 -0
- package/dist/internal/sw.d.mts +4 -0
- package/dist/internal/sw.d.mts.map +1 -0
- package/dist/internal/sw.mjs +10 -0
- package/dist/internal/sw.mjs.map +1 -0
- package/dist/plugins/errors.d.mts +6 -0
- package/dist/plugins/errors.d.mts.map +1 -0
- package/dist/plugins/errors.mjs +59 -0
- package/dist/plugins/errors.mjs.map +1 -0
- package/dist/plugins/fingerprint.d.mts +6 -0
- package/dist/plugins/fingerprint.d.mts.map +1 -0
- package/dist/plugins/fingerprint.mjs +13 -0
- package/dist/plugins/fingerprint.mjs.map +1 -0
- package/dist/plugins/lib/loader.d.mts +10 -0
- package/dist/plugins/lib/loader.d.mts.map +1 -0
- package/dist/plugins/lib/loader.mjs +43 -0
- package/dist/plugins/lib/loader.mjs.map +1 -0
- package/dist/plugins/lib/types.d.mts +14 -0
- package/dist/plugins/lib/types.d.mts.map +1 -0
- package/dist/plugins/lib/types.mjs +1 -0
- package/dist/plugins/pages.d.mts +6 -0
- package/dist/plugins/pages.d.mts.map +1 -0
- package/dist/plugins/pages.mjs +102 -0
- package/dist/plugins/pages.mjs.map +1 -0
- package/dist/plugins/rage-clicks.d.mts +6 -0
- package/dist/plugins/rage-clicks.d.mts.map +1 -0
- package/dist/plugins/rage-clicks.mjs +53 -0
- package/dist/plugins/rage-clicks.mjs.map +1 -0
- package/dist/plugins/replay.d.mts +6 -0
- package/dist/plugins/replay.d.mts.map +1 -0
- package/dist/plugins/replay.mjs +62 -0
- package/dist/plugins/replay.mjs.map +1 -0
- package/dist/provider.d.mts +30 -0
- package/dist/provider.d.mts.map +1 -0
- package/dist/provider.mjs +30 -0
- package/dist/provider.mjs.map +1 -0
- package/dist/tracking/api.d.mts +17 -0
- package/dist/tracking/api.d.mts.map +1 -0
- package/dist/tracking/api.mjs +103 -0
- package/dist/tracking/api.mjs.map +1 -0
- package/dist/tracking/session.d.mts +19 -0
- package/dist/tracking/session.d.mts.map +1 -0
- package/dist/tracking/session.mjs +75 -0
- package/dist/tracking/session.mjs.map +1 -0
- package/dist/tracking/visitor.d.mts +7 -0
- package/dist/tracking/visitor.d.mts.map +1 -0
- package/dist/tracking/visitor.mjs +40 -0
- package/dist/tracking/visitor.mjs.map +1 -0
- package/dist/transport/http.d.mts +17 -0
- package/dist/transport/http.d.mts.map +1 -0
- package/dist/transport/http.mjs +62 -0
- package/dist/transport/http.mjs.map +1 -0
- package/dist/transport/queue.d.mts +31 -0
- package/dist/transport/queue.d.mts.map +1 -0
- package/dist/transport/queue.mjs +89 -0
- package/dist/transport/queue.mjs.map +1 -0
- package/dist/util/log.d.mts +13 -0
- package/dist/util/log.d.mts.map +1 -0
- package/dist/util/log.mjs +37 -0
- package/dist/util/log.mjs.map +1 -0
- package/package.json +24 -24
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import { createLogger } from "../util/log.mjs";
|
|
2
|
+
import { getVisitorId, whenVisitorReady } from "./visitor.mjs";
|
|
3
|
+
import { buildHeaders } from "../transport/http.mjs";
|
|
4
|
+
import { SessionManager } from "./session.mjs";
|
|
5
|
+
//#region src/tracking/api.ts
|
|
6
|
+
const log = createLogger("tracking");
|
|
7
|
+
let mgr = null;
|
|
8
|
+
let target = null;
|
|
9
|
+
let currentIdentity = null;
|
|
10
|
+
let identifiedSessionId = null;
|
|
11
|
+
let syncedSessionId = null;
|
|
12
|
+
let syncAttemptMs = 0;
|
|
13
|
+
const SYNC_COOLDOWN_MS = 5e3;
|
|
14
|
+
function syncSession(sessionId, visitorId) {
|
|
15
|
+
if (!target) return;
|
|
16
|
+
syncAttemptMs = Date.now();
|
|
17
|
+
fetch(target.url, {
|
|
18
|
+
method: "POST",
|
|
19
|
+
headers: buildHeaders(target.headers),
|
|
20
|
+
body: JSON.stringify({
|
|
21
|
+
sessionId,
|
|
22
|
+
visitorId
|
|
23
|
+
}),
|
|
24
|
+
keepalive: true,
|
|
25
|
+
signal: AbortSignal.timeout(1e4)
|
|
26
|
+
}).then((res) => {
|
|
27
|
+
if (res.ok) syncedSessionId = sessionId;
|
|
28
|
+
}).catch(() => {
|
|
29
|
+
log.warn("session sync failed, will retry");
|
|
30
|
+
});
|
|
31
|
+
}
|
|
32
|
+
function ensureSynced(sessionId) {
|
|
33
|
+
if (syncedSessionId === sessionId) return;
|
|
34
|
+
if (Date.now() - syncAttemptMs < SYNC_COOLDOWN_MS) return;
|
|
35
|
+
syncSession(sessionId, getVisitorId());
|
|
36
|
+
}
|
|
37
|
+
async function onRotate(sessionId) {
|
|
38
|
+
syncedSessionId = null;
|
|
39
|
+
if (!target) return;
|
|
40
|
+
const visitorId = await whenVisitorReady();
|
|
41
|
+
log.debug("POST session %s (visitor=%s)", sessionId, visitorId ?? "pending");
|
|
42
|
+
syncSession(sessionId, visitorId);
|
|
43
|
+
}
|
|
44
|
+
function bootstrap(sessionTarget) {
|
|
45
|
+
target = sessionTarget;
|
|
46
|
+
mgr = new SessionManager((id) => {
|
|
47
|
+
onRotate(id).catch(() => {});
|
|
48
|
+
});
|
|
49
|
+
}
|
|
50
|
+
const session = {
|
|
51
|
+
getId() {
|
|
52
|
+
const id = mgr?.getSessionId() ?? null;
|
|
53
|
+
if (id) ensureSynced(id);
|
|
54
|
+
return id;
|
|
55
|
+
},
|
|
56
|
+
getWindowId() {
|
|
57
|
+
return mgr?.getWindowId() ?? null;
|
|
58
|
+
}
|
|
59
|
+
};
|
|
60
|
+
const identity = {
|
|
61
|
+
get() {
|
|
62
|
+
return currentIdentity;
|
|
63
|
+
},
|
|
64
|
+
set(params) {
|
|
65
|
+
if (!(mgr && target)) return;
|
|
66
|
+
const sessionId = mgr.getSessionId();
|
|
67
|
+
if (identifiedSessionId === sessionId) {
|
|
68
|
+
log.debug("skipped, already identified for session %s", sessionId);
|
|
69
|
+
return;
|
|
70
|
+
}
|
|
71
|
+
currentIdentity = params;
|
|
72
|
+
identifiedSessionId = sessionId;
|
|
73
|
+
const visitorId = getVisitorId();
|
|
74
|
+
log.info("PUT session %s → user %s", sessionId, params.identifier);
|
|
75
|
+
fetch(target.url, {
|
|
76
|
+
method: "PUT",
|
|
77
|
+
headers: buildHeaders(target.headers),
|
|
78
|
+
body: JSON.stringify({
|
|
79
|
+
sessionId,
|
|
80
|
+
visitorId,
|
|
81
|
+
...params
|
|
82
|
+
}),
|
|
83
|
+
keepalive: true,
|
|
84
|
+
signal: AbortSignal.timeout(1e4)
|
|
85
|
+
}).catch(() => {
|
|
86
|
+
identifiedSessionId = null;
|
|
87
|
+
log.warn("identify failed for session %s", sessionId);
|
|
88
|
+
});
|
|
89
|
+
},
|
|
90
|
+
clear() {
|
|
91
|
+
currentIdentity = null;
|
|
92
|
+
identifiedSessionId = null;
|
|
93
|
+
}
|
|
94
|
+
};
|
|
95
|
+
function teardown() {
|
|
96
|
+
identity.clear();
|
|
97
|
+
syncedSessionId = null;
|
|
98
|
+
syncAttemptMs = 0;
|
|
99
|
+
mgr = null;
|
|
100
|
+
target = null;
|
|
101
|
+
}
|
|
102
|
+
//#endregion
|
|
103
|
+
export { bootstrap, identity, session, teardown };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"api.mjs","names":[],"sources":["../../src/tracking/api.ts"],"sourcesContent":["import type { IdentifyParams } from \"@interfere/types/sdk/identify\";\n\nimport { buildHeaders, type IngestTarget } from \"../transport/http.js\";\nimport { createLogger } from \"../util/log.js\";\nimport { SessionManager } from \"./session.js\";\nimport { getVisitorId, whenVisitorReady } from \"./visitor.js\";\n\nconst log = createLogger(\"tracking\");\n\nlet mgr: SessionManager | null = null;\nlet target: IngestTarget | null = null;\nlet currentIdentity: IdentifyParams | null = null;\nlet identifiedSessionId: string | null = null;\n\nlet syncedSessionId: string | null = null;\nlet syncAttemptMs = 0;\nconst SYNC_COOLDOWN_MS = 5000;\n\nfunction syncSession(sessionId: string, visitorId: string | null): void {\n if (!target) {\n return;\n }\n\n syncAttemptMs = Date.now();\n\n fetch(target.url, {\n method: \"POST\",\n headers: buildHeaders(target.headers),\n body: JSON.stringify({ sessionId, visitorId }),\n keepalive: true,\n signal: AbortSignal.timeout(10_000),\n })\n .then((res) => {\n if (res.ok) {\n syncedSessionId = sessionId;\n }\n })\n .catch(() => {\n log.warn(\"session sync failed, will retry\");\n });\n}\n\nfunction ensureSynced(sessionId: string): void {\n if (syncedSessionId === sessionId) {\n return;\n }\n if (Date.now() - syncAttemptMs < SYNC_COOLDOWN_MS) {\n return;\n }\n syncSession(sessionId, getVisitorId());\n}\n\nasync function onRotate(sessionId: string): Promise<void> {\n syncedSessionId = null;\n if (!target) {\n return;\n }\n const visitorId = await whenVisitorReady();\n log.debug(\"POST session %s (visitor=%s)\", sessionId, visitorId ?? \"pending\");\n syncSession(sessionId, visitorId);\n}\n\nexport function bootstrap(sessionTarget: IngestTarget): void {\n target = sessionTarget;\n\n mgr = new SessionManager((id) => {\n onRotate(id).catch(() => {\n /* best-effort */\n });\n });\n}\n\nexport const session = {\n getId(): string | null {\n const id = mgr?.getSessionId() ?? null;\n if (id) {\n ensureSynced(id);\n }\n return id;\n },\n\n getWindowId(): string | null {\n return mgr?.getWindowId() ?? null;\n },\n};\n\nexport const identity = {\n get(): IdentifyParams | null {\n return currentIdentity;\n },\n\n set(params: IdentifyParams): void {\n if (!(mgr && target)) {\n return;\n }\n const sessionId = mgr.getSessionId();\n if (identifiedSessionId === sessionId) {\n log.debug(\"skipped, already identified for session %s\", sessionId);\n return;\n }\n\n currentIdentity = params;\n identifiedSessionId = sessionId;\n\n const visitorId = getVisitorId();\n log.info(\"PUT session %s → user %s\", sessionId, params.identifier);\n fetch(target.url, {\n method: \"PUT\",\n headers: buildHeaders(target.headers),\n body: JSON.stringify({ sessionId, visitorId, ...params }),\n keepalive: true,\n signal: AbortSignal.timeout(10_000),\n }).catch(() => {\n identifiedSessionId = null;\n log.warn(\"identify failed for session %s\", sessionId);\n });\n },\n\n clear(): void {\n currentIdentity = null;\n identifiedSessionId = null;\n },\n};\n\nexport function teardown(): void {\n identity.clear();\n syncedSessionId = null;\n syncAttemptMs = 0;\n mgr = null;\n target = null;\n}\n"],"mappings":";;;;;AAOA,MAAM,MAAM,aAAa,WAAW;AAEpC,IAAI,MAA6B;AACjC,IAAI,SAA8B;AAClC,IAAI,kBAAyC;AAC7C,IAAI,sBAAqC;AAEzC,IAAI,kBAAiC;AACrC,IAAI,gBAAgB;AACpB,MAAM,mBAAmB;AAEzB,SAAS,YAAY,WAAmB,WAAgC;AACtE,KAAI,CAAC,OACH;AAGF,iBAAgB,KAAK,KAAK;AAE1B,OAAM,OAAO,KAAK;EAChB,QAAQ;EACR,SAAS,aAAa,OAAO,QAAQ;EACrC,MAAM,KAAK,UAAU;GAAE;GAAW;GAAW,CAAC;EAC9C,WAAW;EACX,QAAQ,YAAY,QAAQ,IAAO;EACpC,CAAC,CACC,MAAM,QAAQ;AACb,MAAI,IAAI,GACN,mBAAkB;GAEpB,CACD,YAAY;AACX,MAAI,KAAK,kCAAkC;GAC3C;;AAGN,SAAS,aAAa,WAAyB;AAC7C,KAAI,oBAAoB,UACtB;AAEF,KAAI,KAAK,KAAK,GAAG,gBAAgB,iBAC/B;AAEF,aAAY,WAAW,cAAc,CAAC;;AAGxC,eAAe,SAAS,WAAkC;AACxD,mBAAkB;AAClB,KAAI,CAAC,OACH;CAEF,MAAM,YAAY,MAAM,kBAAkB;AAC1C,KAAI,MAAM,gCAAgC,WAAW,aAAa,UAAU;AAC5E,aAAY,WAAW,UAAU;;AAGnC,SAAgB,UAAU,eAAmC;AAC3D,UAAS;AAET,OAAM,IAAI,gBAAgB,OAAO;AAC/B,WAAS,GAAG,CAAC,YAAY,GAEvB;GACF;;AAGJ,MAAa,UAAU;CACrB,QAAuB;EACrB,MAAM,KAAK,KAAK,cAAc,IAAI;AAClC,MAAI,GACF,cAAa,GAAG;AAElB,SAAO;;CAGT,cAA6B;AAC3B,SAAO,KAAK,aAAa,IAAI;;CAEhC;AAED,MAAa,WAAW;CACtB,MAA6B;AAC3B,SAAO;;CAGT,IAAI,QAA8B;AAChC,MAAI,EAAE,OAAO,QACX;EAEF,MAAM,YAAY,IAAI,cAAc;AACpC,MAAI,wBAAwB,WAAW;AACrC,OAAI,MAAM,8CAA8C,UAAU;AAClE;;AAGF,oBAAkB;AAClB,wBAAsB;EAEtB,MAAM,YAAY,cAAc;AAChC,MAAI,KAAK,4BAA4B,WAAW,OAAO,WAAW;AAClE,QAAM,OAAO,KAAK;GAChB,QAAQ;GACR,SAAS,aAAa,OAAO,QAAQ;GACrC,MAAM,KAAK,UAAU;IAAE;IAAW;IAAW,GAAG;IAAQ,CAAC;GACzD,WAAW;GACX,QAAQ,YAAY,QAAQ,IAAO;GACpC,CAAC,CAAC,YAAY;AACb,yBAAsB;AACtB,OAAI,KAAK,kCAAkC,UAAU;IACrD;;CAGJ,QAAc;AACZ,oBAAkB;AAClB,wBAAsB;;CAEzB;AAED,SAAgB,WAAiB;AAC/B,UAAS,OAAO;AAChB,mBAAkB;AAClB,iBAAgB;AAChB,OAAM;AACN,UAAS"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
//#region src/tracking/session.d.ts
|
|
2
|
+
type OnRotate = (sessionId: string) => void;
|
|
3
|
+
declare class SessionManager {
|
|
4
|
+
sessionId: string | null;
|
|
5
|
+
windowId: string | null;
|
|
6
|
+
private readonly local;
|
|
7
|
+
private readonly session;
|
|
8
|
+
private readonly onRotate;
|
|
9
|
+
private lastActivityMs;
|
|
10
|
+
constructor(onRotate?: OnRotate);
|
|
11
|
+
getSessionId(): string;
|
|
12
|
+
getWindowId(): string;
|
|
13
|
+
private restore;
|
|
14
|
+
private rotate;
|
|
15
|
+
private touch;
|
|
16
|
+
private isExpired;
|
|
17
|
+
}
|
|
18
|
+
//#endregion
|
|
19
|
+
export { OnRotate, SessionManager };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"session.d.mts","names":[],"sources":["../../src/tracking/session.ts"],"mappings":";KAmBY,QAAA,IAAY,SAAA;AAAA,cAEX,cAAA;EACX,SAAA;EACA,QAAA;EAAA,iBACiB,KAAA;EAAA,iBACA,OAAA;EAAA,iBACA,QAAA;EAAA,QACT,cAAA;cAEI,QAAA,GAAW,QAAA;EAOvB,YAAA,CAAA;EAQA,WAAA,CAAA;EAAA,QAgBQ,OAAA;EAAA,QAWA,MAAA;EAAA,QAQA,KAAA;EAAA,QAKA,SAAA;AAAA"}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import { v7 } from "uuid";
|
|
2
|
+
//#region src/tracking/session.ts
|
|
3
|
+
const SESSION_ID_KEY = "interfere:session_id";
|
|
4
|
+
const LAST_ACTIVITY_KEY = "interfere:last_activity";
|
|
5
|
+
const WINDOW_ID_KEY = "interfere:window_id";
|
|
6
|
+
const SESSION_TIMEOUT_MS = 1800 * 1e3;
|
|
7
|
+
function tryStorage(type) {
|
|
8
|
+
try {
|
|
9
|
+
const s = globalThis[type];
|
|
10
|
+
const key = "__interfere_probe__";
|
|
11
|
+
s.setItem(key, "1");
|
|
12
|
+
s.removeItem(key);
|
|
13
|
+
return s;
|
|
14
|
+
} catch {
|
|
15
|
+
return null;
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
var SessionManager = class {
|
|
19
|
+
sessionId = null;
|
|
20
|
+
windowId = null;
|
|
21
|
+
local;
|
|
22
|
+
session;
|
|
23
|
+
onRotate = null;
|
|
24
|
+
lastActivityMs = 0;
|
|
25
|
+
constructor(onRotate) {
|
|
26
|
+
this.local = tryStorage("localStorage");
|
|
27
|
+
this.session = tryStorage("sessionStorage");
|
|
28
|
+
this.onRotate = onRotate ?? null;
|
|
29
|
+
this.restore();
|
|
30
|
+
}
|
|
31
|
+
getSessionId() {
|
|
32
|
+
if (this.sessionId && !this.isExpired()) {
|
|
33
|
+
this.touch();
|
|
34
|
+
return this.sessionId;
|
|
35
|
+
}
|
|
36
|
+
return this.rotate();
|
|
37
|
+
}
|
|
38
|
+
getWindowId() {
|
|
39
|
+
if (this.windowId) return this.windowId;
|
|
40
|
+
const stored = this.session?.getItem(WINDOW_ID_KEY);
|
|
41
|
+
if (stored) {
|
|
42
|
+
this.windowId = stored;
|
|
43
|
+
return stored;
|
|
44
|
+
}
|
|
45
|
+
this.windowId = `win_${crypto.randomUUID()}`;
|
|
46
|
+
this.session?.setItem(WINDOW_ID_KEY, this.windowId);
|
|
47
|
+
return this.windowId;
|
|
48
|
+
}
|
|
49
|
+
restore() {
|
|
50
|
+
const stored = this.local?.getItem(SESSION_ID_KEY);
|
|
51
|
+
if (stored && !this.isExpired()) {
|
|
52
|
+
this.sessionId = stored;
|
|
53
|
+
this.touch();
|
|
54
|
+
} else this.rotate();
|
|
55
|
+
}
|
|
56
|
+
rotate() {
|
|
57
|
+
this.sessionId = v7();
|
|
58
|
+
this.local?.setItem(SESSION_ID_KEY, this.sessionId);
|
|
59
|
+
this.touch();
|
|
60
|
+
this.onRotate?.(this.sessionId);
|
|
61
|
+
return this.sessionId;
|
|
62
|
+
}
|
|
63
|
+
touch() {
|
|
64
|
+
this.lastActivityMs = Date.now();
|
|
65
|
+
this.local?.setItem(LAST_ACTIVITY_KEY, String(this.lastActivityMs));
|
|
66
|
+
}
|
|
67
|
+
isExpired() {
|
|
68
|
+
const raw = this.local?.getItem(LAST_ACTIVITY_KEY);
|
|
69
|
+
const ts = raw ? Number(raw) : this.lastActivityMs;
|
|
70
|
+
if (ts === 0) return true;
|
|
71
|
+
return Date.now() - ts > SESSION_TIMEOUT_MS;
|
|
72
|
+
}
|
|
73
|
+
};
|
|
74
|
+
//#endregion
|
|
75
|
+
export { SessionManager };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"session.mjs","names":["uuidv7"],"sources":["../../src/tracking/session.ts"],"sourcesContent":["import { v7 as uuidv7 } from \"uuid\";\n\nconst SESSION_ID_KEY = \"interfere:session_id\";\nconst LAST_ACTIVITY_KEY = \"interfere:last_activity\";\nconst WINDOW_ID_KEY = \"interfere:window_id\";\nconst SESSION_TIMEOUT_MS = 30 * 60 * 1000;\n\nfunction tryStorage(type: \"localStorage\" | \"sessionStorage\"): Storage | null {\n try {\n const s = globalThis[type];\n const key = \"__interfere_probe__\";\n s.setItem(key, \"1\");\n s.removeItem(key);\n return s;\n } catch {\n return null;\n }\n}\n\nexport type OnRotate = (sessionId: string) => void;\n\nexport class SessionManager {\n sessionId: string | null = null;\n windowId: string | null = null;\n private readonly local: Storage | null;\n private readonly session: Storage | null;\n private readonly onRotate: OnRotate | null = null;\n private lastActivityMs = 0;\n\n constructor(onRotate?: OnRotate) {\n this.local = tryStorage(\"localStorage\");\n this.session = tryStorage(\"sessionStorage\");\n this.onRotate = onRotate ?? null;\n this.restore();\n }\n\n getSessionId(): string {\n if (this.sessionId && !this.isExpired()) {\n this.touch();\n return this.sessionId;\n }\n return this.rotate();\n }\n\n getWindowId(): string {\n if (this.windowId) {\n return this.windowId;\n }\n\n const stored = this.session?.getItem(WINDOW_ID_KEY);\n if (stored) {\n this.windowId = stored;\n return stored;\n }\n\n this.windowId = `win_${crypto.randomUUID()}`;\n this.session?.setItem(WINDOW_ID_KEY, this.windowId);\n return this.windowId;\n }\n\n private restore(): void {\n const stored = this.local?.getItem(SESSION_ID_KEY);\n\n if (stored && !this.isExpired()) {\n this.sessionId = stored;\n this.touch();\n } else {\n this.rotate();\n }\n }\n\n private rotate(): string {\n this.sessionId = uuidv7();\n this.local?.setItem(SESSION_ID_KEY, this.sessionId);\n this.touch();\n this.onRotate?.(this.sessionId);\n return this.sessionId;\n }\n\n private touch(): void {\n this.lastActivityMs = Date.now();\n this.local?.setItem(LAST_ACTIVITY_KEY, String(this.lastActivityMs));\n }\n\n private isExpired(): boolean {\n const raw = this.local?.getItem(LAST_ACTIVITY_KEY);\n const ts = raw ? Number(raw) : this.lastActivityMs;\n\n if (ts === 0) {\n return true;\n }\n return Date.now() - ts > SESSION_TIMEOUT_MS;\n }\n}\n"],"mappings":";;AAEA,MAAM,iBAAiB;AACvB,MAAM,oBAAoB;AAC1B,MAAM,gBAAgB;AACtB,MAAM,qBAAqB,OAAU;AAErC,SAAS,WAAW,MAAyD;AAC3E,KAAI;EACF,MAAM,IAAI,WAAW;EACrB,MAAM,MAAM;AACZ,IAAE,QAAQ,KAAK,IAAI;AACnB,IAAE,WAAW,IAAI;AACjB,SAAO;SACD;AACN,SAAO;;;AAMX,IAAa,iBAAb,MAA4B;CAC1B,YAA2B;CAC3B,WAA0B;CAC1B;CACA;CACA,WAA6C;CAC7C,iBAAyB;CAEzB,YAAY,UAAqB;AAC/B,OAAK,QAAQ,WAAW,eAAe;AACvC,OAAK,UAAU,WAAW,iBAAiB;AAC3C,OAAK,WAAW,YAAY;AAC5B,OAAK,SAAS;;CAGhB,eAAuB;AACrB,MAAI,KAAK,aAAa,CAAC,KAAK,WAAW,EAAE;AACvC,QAAK,OAAO;AACZ,UAAO,KAAK;;AAEd,SAAO,KAAK,QAAQ;;CAGtB,cAAsB;AACpB,MAAI,KAAK,SACP,QAAO,KAAK;EAGd,MAAM,SAAS,KAAK,SAAS,QAAQ,cAAc;AACnD,MAAI,QAAQ;AACV,QAAK,WAAW;AAChB,UAAO;;AAGT,OAAK,WAAW,OAAO,OAAO,YAAY;AAC1C,OAAK,SAAS,QAAQ,eAAe,KAAK,SAAS;AACnD,SAAO,KAAK;;CAGd,UAAwB;EACtB,MAAM,SAAS,KAAK,OAAO,QAAQ,eAAe;AAElD,MAAI,UAAU,CAAC,KAAK,WAAW,EAAE;AAC/B,QAAK,YAAY;AACjB,QAAK,OAAO;QAEZ,MAAK,QAAQ;;CAIjB,SAAyB;AACvB,OAAK,YAAYA,IAAQ;AACzB,OAAK,OAAO,QAAQ,gBAAgB,KAAK,UAAU;AACnD,OAAK,OAAO;AACZ,OAAK,WAAW,KAAK,UAAU;AAC/B,SAAO,KAAK;;CAGd,QAAsB;AACpB,OAAK,iBAAiB,KAAK,KAAK;AAChC,OAAK,OAAO,QAAQ,mBAAmB,OAAO,KAAK,eAAe,CAAC;;CAGrE,YAA6B;EAC3B,MAAM,MAAM,KAAK,OAAO,QAAQ,kBAAkB;EAClD,MAAM,KAAK,MAAM,OAAO,IAAI,GAAG,KAAK;AAEpC,MAAI,OAAO,EACT,QAAO;AAET,SAAO,KAAK,KAAK,GAAG,KAAK"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
//#region src/tracking/visitor.d.ts
|
|
2
|
+
declare function initVisitor(): void;
|
|
3
|
+
declare function getVisitorId(): string | null;
|
|
4
|
+
declare function whenVisitorReady(): Promise<string | null>;
|
|
5
|
+
declare function resetVisitor(): void;
|
|
6
|
+
//#endregion
|
|
7
|
+
export { getVisitorId, initVisitor, resetVisitor, whenVisitorReady };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"visitor.d.mts","names":[],"sources":["../../src/tracking/visitor.ts"],"mappings":";iBAcgB,WAAA,CAAA;AAAA,iBA+BA,YAAA,CAAA;AAAA,iBAIA,gBAAA,CAAA,GAAoB,OAAA;AAAA,iBAOpB,YAAA,CAAA"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { createLogger } from "../util/log.mjs";
|
|
2
|
+
//#region src/tracking/visitor.ts
|
|
3
|
+
const log = createLogger("visitor");
|
|
4
|
+
let visitorId = null;
|
|
5
|
+
let pending = null;
|
|
6
|
+
function resolveApiKey() {
|
|
7
|
+
if (typeof process === "undefined") return;
|
|
8
|
+
return process.env.INTERFERE_FINGERPRINT_KEY ?? void 0;
|
|
9
|
+
}
|
|
10
|
+
function initVisitor() {
|
|
11
|
+
if (visitorId || pending) return;
|
|
12
|
+
const apiKey = resolveApiKey();
|
|
13
|
+
if (!apiKey) {
|
|
14
|
+
log.info("no INTERFERE_FINGERPRINT_KEY, skipping");
|
|
15
|
+
return;
|
|
16
|
+
}
|
|
17
|
+
pending = (async () => {
|
|
18
|
+
try {
|
|
19
|
+
visitorId = (await (await (await import("@fingerprintjs/fingerprintjs-pro")).load({ apiKey })).get()).visitorId;
|
|
20
|
+
log.debug("resolved %s", visitorId);
|
|
21
|
+
return visitorId;
|
|
22
|
+
} catch {
|
|
23
|
+
log.error("fingerprint failed");
|
|
24
|
+
return null;
|
|
25
|
+
}
|
|
26
|
+
})();
|
|
27
|
+
}
|
|
28
|
+
function getVisitorId() {
|
|
29
|
+
return visitorId;
|
|
30
|
+
}
|
|
31
|
+
function whenVisitorReady() {
|
|
32
|
+
if (visitorId) return Promise.resolve(visitorId);
|
|
33
|
+
return pending ?? Promise.resolve(null);
|
|
34
|
+
}
|
|
35
|
+
function resetVisitor() {
|
|
36
|
+
visitorId = null;
|
|
37
|
+
pending = null;
|
|
38
|
+
}
|
|
39
|
+
//#endregion
|
|
40
|
+
export { getVisitorId, initVisitor, resetVisitor, whenVisitorReady };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"visitor.mjs","names":[],"sources":["../../src/tracking/visitor.ts"],"sourcesContent":["import { createLogger } from \"../util/log.js\";\n\nconst log = createLogger(\"visitor\");\n\nlet visitorId: string | null = null;\nlet pending: Promise<string | null> | null = null;\n\nfunction resolveApiKey(): string | undefined {\n if (typeof process === \"undefined\") {\n return undefined;\n }\n return process.env.INTERFERE_FINGERPRINT_KEY ?? undefined;\n}\n\nexport function initVisitor(): void {\n if (visitorId || pending) {\n return;\n }\n\n const apiKey = resolveApiKey();\n if (!apiKey) {\n log.info(\"no INTERFERE_FINGERPRINT_KEY, skipping\");\n return;\n }\n\n pending = (async () => {\n try {\n const FingerprintJS = await import(\"@fingerprintjs/fingerprintjs-pro\");\n\n const fp = await FingerprintJS.load({ apiKey });\n const result = await fp.get();\n\n visitorId = result.visitorId;\n\n log.debug(\"resolved %s\", visitorId);\n\n return visitorId;\n } catch {\n log.error(\"fingerprint failed\");\n\n return null;\n }\n })();\n}\n\nexport function getVisitorId(): string | null {\n return visitorId;\n}\n\nexport function whenVisitorReady(): Promise<string | null> {\n if (visitorId) {\n return Promise.resolve(visitorId);\n }\n return pending ?? Promise.resolve(null);\n}\n\nexport function resetVisitor(): void {\n visitorId = null;\n pending = null;\n}\n"],"mappings":";;AAEA,MAAM,MAAM,aAAa,UAAU;AAEnC,IAAI,YAA2B;AAC/B,IAAI,UAAyC;AAE7C,SAAS,gBAAoC;AAC3C,KAAI,OAAO,YAAY,YACrB;AAEF,QAAO,QAAQ,IAAI,6BAA6B,KAAA;;AAGlD,SAAgB,cAAoB;AAClC,KAAI,aAAa,QACf;CAGF,MAAM,SAAS,eAAe;AAC9B,KAAI,CAAC,QAAQ;AACX,MAAI,KAAK,yCAAyC;AAClD;;AAGF,YAAW,YAAY;AACrB,MAAI;AAMF,gBAFe,OADJ,OAFW,MAAM,OAAO,qCAEJ,KAAK,EAAE,QAAQ,CAAC,EACvB,KAAK,EAEV;AAEnB,OAAI,MAAM,eAAe,UAAU;AAEnC,UAAO;UACD;AACN,OAAI,MAAM,qBAAqB;AAE/B,UAAO;;KAEP;;AAGN,SAAgB,eAA8B;AAC5C,QAAO;;AAGT,SAAgB,mBAA2C;AACzD,KAAI,UACF,QAAO,QAAQ,QAAQ,UAAU;AAEnC,QAAO,WAAW,QAAQ,QAAQ,KAAK;;AAGzC,SAAgB,eAAqB;AACnC,aAAY;AACZ,WAAU"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { Envelope } from "@interfere/types/sdk/envelope";
|
|
2
|
+
|
|
3
|
+
//#region src/transport/http.d.ts
|
|
4
|
+
interface IngestTarget {
|
|
5
|
+
headers: Headers;
|
|
6
|
+
url: string;
|
|
7
|
+
}
|
|
8
|
+
declare function buildHeaders(base: Headers): Record<string, string>;
|
|
9
|
+
declare function hasServiceWorker(): boolean;
|
|
10
|
+
declare class HttpTransport {
|
|
11
|
+
private readonly target;
|
|
12
|
+
private pendingKeepalive;
|
|
13
|
+
constructor(target: IngestTarget);
|
|
14
|
+
send(envelopes: Envelope[]): Promise<void>;
|
|
15
|
+
}
|
|
16
|
+
//#endregion
|
|
17
|
+
export { HttpTransport, IngestTarget, buildHeaders, hasServiceWorker };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http.d.mts","names":[],"sources":["../../src/transport/http.ts"],"mappings":";;;UAYiB,YAAA;EACf,OAAA,EAAS,OAAA;EACT,GAAA;AAAA;AAAA,iBAGc,YAAA,CAAa,IAAA,EAAM,OAAA,GAAU,MAAA;AAAA,iBAiB7B,gBAAA,CAAA;AAAA,cAiBH,aAAA;EAAA,iBACM,MAAA;EAAA,QACT,gBAAA;cAEI,MAAA,EAAQ,YAAA;EAId,IAAA,CAAK,SAAA,EAAW,QAAA,KAAa,OAAA;AAAA"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { createLogger } from "../util/log.mjs";
|
|
2
|
+
import { getVisitorId } from "../tracking/visitor.mjs";
|
|
3
|
+
import { session } from "../tracking/api.mjs";
|
|
4
|
+
import { make } from "tctx/traceparent";
|
|
5
|
+
//#region src/transport/http.ts
|
|
6
|
+
const log = createLogger("http");
|
|
7
|
+
const SEND_TIMEOUT_MS = 1e4;
|
|
8
|
+
function buildHeaders(base) {
|
|
9
|
+
const h = Object.fromEntries(base.entries());
|
|
10
|
+
h.traceparent = String(make());
|
|
11
|
+
const sessionId = session.getId();
|
|
12
|
+
if (sessionId) h["x-interfere-session"] = sessionId;
|
|
13
|
+
const visitorId = getVisitorId();
|
|
14
|
+
if (visitorId) h["x-interfere-visitor"] = visitorId;
|
|
15
|
+
return h;
|
|
16
|
+
}
|
|
17
|
+
function hasServiceWorker() {
|
|
18
|
+
return typeof navigator !== "undefined" && "serviceWorker" in navigator && navigator.serviceWorker.controller !== null;
|
|
19
|
+
}
|
|
20
|
+
function assertOk(response) {
|
|
21
|
+
if (!response.ok) throw new Error(`ingest responded ${response.status}`);
|
|
22
|
+
}
|
|
23
|
+
const KEEPALIVE_BUDGET_BYTES = 61440;
|
|
24
|
+
const MAX_CONCURRENT_KEEPALIVE = 15;
|
|
25
|
+
var HttpTransport = class {
|
|
26
|
+
target;
|
|
27
|
+
pendingKeepalive = 0;
|
|
28
|
+
constructor(target) {
|
|
29
|
+
this.target = target;
|
|
30
|
+
}
|
|
31
|
+
async send(envelopes) {
|
|
32
|
+
const body = JSON.stringify(envelopes);
|
|
33
|
+
const headers = buildHeaders(this.target.headers);
|
|
34
|
+
if (hasServiceWorker()) {
|
|
35
|
+
log.debug("POST %d envelopes via SW", envelopes.length);
|
|
36
|
+
assertOk(await fetch(this.target.url, {
|
|
37
|
+
method: "POST",
|
|
38
|
+
headers,
|
|
39
|
+
body,
|
|
40
|
+
signal: AbortSignal.timeout(SEND_TIMEOUT_MS)
|
|
41
|
+
}));
|
|
42
|
+
return;
|
|
43
|
+
}
|
|
44
|
+
const bytes = new TextEncoder().encode(body).byteLength;
|
|
45
|
+
const useKeepalive = bytes < KEEPALIVE_BUDGET_BYTES && this.pendingKeepalive < MAX_CONCURRENT_KEEPALIVE;
|
|
46
|
+
if (useKeepalive) this.pendingKeepalive++;
|
|
47
|
+
log.debug("POST %d envelopes direct (%d bytes, keepalive=%s)", envelopes.length, bytes, useKeepalive);
|
|
48
|
+
try {
|
|
49
|
+
assertOk(await fetch(this.target.url, {
|
|
50
|
+
method: "POST",
|
|
51
|
+
headers,
|
|
52
|
+
body,
|
|
53
|
+
keepalive: useKeepalive,
|
|
54
|
+
signal: AbortSignal.timeout(SEND_TIMEOUT_MS)
|
|
55
|
+
}));
|
|
56
|
+
} finally {
|
|
57
|
+
if (useKeepalive) this.pendingKeepalive--;
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
};
|
|
61
|
+
//#endregion
|
|
62
|
+
export { HttpTransport, buildHeaders, hasServiceWorker };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http.mjs","names":[],"sources":["../../src/transport/http.ts"],"sourcesContent":["import type { Envelope } from \"@interfere/types/sdk/envelope\";\n\nimport { make } from \"tctx/traceparent\";\n\nimport { session } from \"../tracking/api.js\";\nimport { getVisitorId } from \"../tracking/visitor.js\";\nimport { createLogger } from \"../util/log.js\";\n\nconst log = createLogger(\"http\");\n\nconst SEND_TIMEOUT_MS = 10_000;\n\nexport interface IngestTarget {\n headers: Headers;\n url: string;\n}\n\nexport function buildHeaders(base: Headers): Record<string, string> {\n const h: Record<string, string> = Object.fromEntries(base.entries());\n h.traceparent = String(make());\n\n const sessionId = session.getId();\n if (sessionId) {\n h[\"x-interfere-session\"] = sessionId;\n }\n\n const visitorId = getVisitorId();\n if (visitorId) {\n h[\"x-interfere-visitor\"] = visitorId;\n }\n\n return h;\n}\n\nexport function hasServiceWorker(): boolean {\n return (\n typeof navigator !== \"undefined\" &&\n \"serviceWorker\" in navigator &&\n navigator.serviceWorker.controller !== null\n );\n}\n\nfunction assertOk(response: Response): void {\n if (!response.ok) {\n throw new Error(`ingest responded ${response.status}`);\n }\n}\n\nconst KEEPALIVE_BUDGET_BYTES = 61_440;\nconst MAX_CONCURRENT_KEEPALIVE = 15;\n\nexport class HttpTransport {\n private readonly target: IngestTarget;\n private pendingKeepalive = 0;\n\n constructor(target: IngestTarget) {\n this.target = target;\n }\n\n async send(envelopes: Envelope[]): Promise<void> {\n const body = JSON.stringify(envelopes);\n const headers = buildHeaders(this.target.headers);\n\n if (hasServiceWorker()) {\n log.debug(\"POST %d envelopes via SW\", envelopes.length);\n const res = await fetch(this.target.url, {\n method: \"POST\",\n headers,\n body,\n signal: AbortSignal.timeout(SEND_TIMEOUT_MS),\n });\n assertOk(res);\n return;\n }\n\n const bytes = new TextEncoder().encode(body).byteLength;\n const useKeepalive =\n bytes < KEEPALIVE_BUDGET_BYTES &&\n this.pendingKeepalive < MAX_CONCURRENT_KEEPALIVE;\n\n if (useKeepalive) {\n this.pendingKeepalive++;\n }\n\n log.debug(\n \"POST %d envelopes direct (%d bytes, keepalive=%s)\",\n envelopes.length,\n bytes,\n useKeepalive\n );\n\n try {\n const res = await fetch(this.target.url, {\n method: \"POST\",\n headers,\n body,\n keepalive: useKeepalive,\n signal: AbortSignal.timeout(SEND_TIMEOUT_MS),\n });\n assertOk(res);\n } finally {\n if (useKeepalive) {\n this.pendingKeepalive--;\n }\n }\n }\n}\n"],"mappings":";;;;;AAQA,MAAM,MAAM,aAAa,OAAO;AAEhC,MAAM,kBAAkB;AAOxB,SAAgB,aAAa,MAAuC;CAClE,MAAM,IAA4B,OAAO,YAAY,KAAK,SAAS,CAAC;AACpE,GAAE,cAAc,OAAO,MAAM,CAAC;CAE9B,MAAM,YAAY,QAAQ,OAAO;AACjC,KAAI,UACF,GAAE,yBAAyB;CAG7B,MAAM,YAAY,cAAc;AAChC,KAAI,UACF,GAAE,yBAAyB;AAG7B,QAAO;;AAGT,SAAgB,mBAA4B;AAC1C,QACE,OAAO,cAAc,eACrB,mBAAmB,aACnB,UAAU,cAAc,eAAe;;AAI3C,SAAS,SAAS,UAA0B;AAC1C,KAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,oBAAoB,SAAS,SAAS;;AAI1D,MAAM,yBAAyB;AAC/B,MAAM,2BAA2B;AAEjC,IAAa,gBAAb,MAA2B;CACzB;CACA,mBAA2B;CAE3B,YAAY,QAAsB;AAChC,OAAK,SAAS;;CAGhB,MAAM,KAAK,WAAsC;EAC/C,MAAM,OAAO,KAAK,UAAU,UAAU;EACtC,MAAM,UAAU,aAAa,KAAK,OAAO,QAAQ;AAEjD,MAAI,kBAAkB,EAAE;AACtB,OAAI,MAAM,4BAA4B,UAAU,OAAO;AAOvD,YANY,MAAM,MAAM,KAAK,OAAO,KAAK;IACvC,QAAQ;IACR;IACA;IACA,QAAQ,YAAY,QAAQ,gBAAgB;IAC7C,CAAC,CACW;AACb;;EAGF,MAAM,QAAQ,IAAI,aAAa,CAAC,OAAO,KAAK,CAAC;EAC7C,MAAM,eACJ,QAAQ,0BACR,KAAK,mBAAmB;AAE1B,MAAI,aACF,MAAK;AAGP,MAAI,MACF,qDACA,UAAU,QACV,OACA,aACD;AAED,MAAI;AAQF,YAPY,MAAM,MAAM,KAAK,OAAO,KAAK;IACvC,QAAQ;IACR;IACA;IACA,WAAW;IACX,QAAQ,YAAY,QAAQ,gBAAgB;IAC7C,CAAC,CACW;YACL;AACR,OAAI,aACF,MAAK"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { HttpTransport } from "./http.mjs";
|
|
2
|
+
import { Envelope } from "@interfere/types/sdk/envelope";
|
|
3
|
+
|
|
4
|
+
//#region src/transport/queue.d.ts
|
|
5
|
+
interface QueueOptions {
|
|
6
|
+
batchMs?: number;
|
|
7
|
+
batchSize?: number;
|
|
8
|
+
maxBufferSize?: number;
|
|
9
|
+
transport: HttpTransport;
|
|
10
|
+
}
|
|
11
|
+
declare class BatchQueue {
|
|
12
|
+
private readonly buffer;
|
|
13
|
+
private timer;
|
|
14
|
+
private flushing;
|
|
15
|
+
private failures;
|
|
16
|
+
private pausedUntil;
|
|
17
|
+
private readonly batchSize;
|
|
18
|
+
private readonly batchMs;
|
|
19
|
+
private readonly maxBufferSize;
|
|
20
|
+
private readonly transport;
|
|
21
|
+
constructor(opts: QueueOptions);
|
|
22
|
+
start(): void;
|
|
23
|
+
enqueue(envelope: Envelope): void;
|
|
24
|
+
flush(): void;
|
|
25
|
+
dispose(): void;
|
|
26
|
+
private drain;
|
|
27
|
+
private readonly onVisibilityChange;
|
|
28
|
+
private readonly onBeforeUnload;
|
|
29
|
+
}
|
|
30
|
+
//#endregion
|
|
31
|
+
export { BatchQueue, QueueOptions };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"queue.d.mts","names":[],"sources":["../../src/transport/queue.ts"],"mappings":";;;;UAciB,YAAA;EACf,OAAA;EACA,SAAA;EACA,aAAA;EACA,SAAA,EAAW,aAAA;AAAA;AAAA,cAGA,UAAA;EAAA,iBACM,MAAA;EAAA,QACT,KAAA;EAAA,QACA,QAAA;EAAA,QACA,QAAA;EAAA,QACA,WAAA;EAAA,iBACS,SAAA;EAAA,iBACA,OAAA;EAAA,iBACA,aAAA;EAAA,iBACA,SAAA;cAEL,IAAA,EAAM,YAAA;EAOlB,KAAA,CAAA;EAeA,OAAA,CAAQ,QAAA,EAAU,QAAA;EAclB,KAAA,CAAA;EAuCA,OAAA,CAAA;EAAA,QAiBQ,KAAA;EAAA,iBASS,kBAAA;EAAA,iBAMA,cAAA;AAAA"}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import { createLogger } from "../util/log.mjs";
|
|
2
|
+
import { hasServiceWorker } from "./http.mjs";
|
|
3
|
+
//#region src/transport/queue.ts
|
|
4
|
+
const log = createLogger("queue");
|
|
5
|
+
const DEFAULT_BATCH_SIZE = 10;
|
|
6
|
+
const DEFAULT_BATCH_MS = 250;
|
|
7
|
+
const DEFAULT_MAX_BUFFER_SIZE = 1e3;
|
|
8
|
+
const BREAKER_THRESHOLD = 5;
|
|
9
|
+
const BREAKER_COOLDOWN_MS = 3e4;
|
|
10
|
+
var BatchQueue = class {
|
|
11
|
+
buffer = [];
|
|
12
|
+
timer = null;
|
|
13
|
+
flushing = false;
|
|
14
|
+
failures = 0;
|
|
15
|
+
pausedUntil = 0;
|
|
16
|
+
batchSize;
|
|
17
|
+
batchMs;
|
|
18
|
+
maxBufferSize;
|
|
19
|
+
transport;
|
|
20
|
+
constructor(opts) {
|
|
21
|
+
this.batchSize = opts.batchSize ?? DEFAULT_BATCH_SIZE;
|
|
22
|
+
this.batchMs = opts.batchMs ?? DEFAULT_BATCH_MS;
|
|
23
|
+
this.maxBufferSize = opts.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE;
|
|
24
|
+
this.transport = opts.transport;
|
|
25
|
+
}
|
|
26
|
+
start() {
|
|
27
|
+
if (this.timer) return;
|
|
28
|
+
this.timer = setInterval(() => {
|
|
29
|
+
this.flush();
|
|
30
|
+
}, this.batchMs);
|
|
31
|
+
if (typeof globalThis.addEventListener === "function") {
|
|
32
|
+
globalThis.addEventListener("visibilitychange", this.onVisibilityChange);
|
|
33
|
+
globalThis.addEventListener("beforeunload", this.onBeforeUnload);
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
enqueue(envelope) {
|
|
37
|
+
this.buffer.push(envelope);
|
|
38
|
+
if (this.buffer.length > this.maxBufferSize) {
|
|
39
|
+
const overflow = this.buffer.length - this.maxBufferSize;
|
|
40
|
+
this.buffer.splice(0, overflow);
|
|
41
|
+
log.warn("buffer full, dropped %d oldest envelopes", overflow);
|
|
42
|
+
}
|
|
43
|
+
if (this.buffer.length >= this.batchSize) this.flush();
|
|
44
|
+
}
|
|
45
|
+
flush() {
|
|
46
|
+
if (this.flushing || this.buffer.length === 0) return;
|
|
47
|
+
if (this.failures >= BREAKER_THRESHOLD && Date.now() < this.pausedUntil) return;
|
|
48
|
+
this.flushing = true;
|
|
49
|
+
const batch = this.buffer.splice(0, this.batchSize);
|
|
50
|
+
this.transport.send(batch).then(() => {
|
|
51
|
+
if (this.failures > 0) log.info("send recovered after %d failures", this.failures);
|
|
52
|
+
this.failures = 0;
|
|
53
|
+
}).catch(() => {
|
|
54
|
+
if (!hasServiceWorker()) this.buffer.unshift(...batch);
|
|
55
|
+
this.failures++;
|
|
56
|
+
if (this.failures >= BREAKER_THRESHOLD) {
|
|
57
|
+
this.pausedUntil = Date.now() + BREAKER_COOLDOWN_MS;
|
|
58
|
+
log.warn("pausing sends for %dms after %d consecutive failures", BREAKER_COOLDOWN_MS, this.failures);
|
|
59
|
+
}
|
|
60
|
+
}).finally(() => {
|
|
61
|
+
this.flushing = false;
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
dispose() {
|
|
65
|
+
if (this.timer) {
|
|
66
|
+
clearInterval(this.timer);
|
|
67
|
+
this.timer = null;
|
|
68
|
+
}
|
|
69
|
+
if (typeof globalThis.removeEventListener === "function") {
|
|
70
|
+
globalThis.removeEventListener("visibilitychange", this.onVisibilityChange);
|
|
71
|
+
globalThis.removeEventListener("beforeunload", this.onBeforeUnload);
|
|
72
|
+
}
|
|
73
|
+
this.drain();
|
|
74
|
+
}
|
|
75
|
+
drain() {
|
|
76
|
+
while (this.buffer.length > 0) {
|
|
77
|
+
const batch = this.buffer.splice(0, this.batchSize);
|
|
78
|
+
this.transport.send(batch).catch(() => {});
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
onVisibilityChange = () => {
|
|
82
|
+
if (document.visibilityState === "hidden") this.drain();
|
|
83
|
+
};
|
|
84
|
+
onBeforeUnload = () => {
|
|
85
|
+
this.drain();
|
|
86
|
+
};
|
|
87
|
+
};
|
|
88
|
+
//#endregion
|
|
89
|
+
export { BatchQueue };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"queue.mjs","names":[],"sources":["../../src/transport/queue.ts"],"sourcesContent":["import type { Envelope } from \"@interfere/types/sdk/envelope\";\n\nimport { createLogger } from \"../util/log.js\";\nimport { type HttpTransport, hasServiceWorker } from \"./http.js\";\n\nconst log = createLogger(\"queue\");\n\nconst DEFAULT_BATCH_SIZE = 10;\nconst DEFAULT_BATCH_MS = 250;\nconst DEFAULT_MAX_BUFFER_SIZE = 1000;\n\nconst BREAKER_THRESHOLD = 5;\nconst BREAKER_COOLDOWN_MS = 30_000;\n\nexport interface QueueOptions {\n batchMs?: number;\n batchSize?: number;\n maxBufferSize?: number;\n transport: HttpTransport;\n}\n\nexport class BatchQueue {\n private readonly buffer: Envelope[] = [];\n private timer: ReturnType<typeof setInterval> | null = null;\n private flushing = false;\n private failures = 0;\n private pausedUntil = 0;\n private readonly batchSize: number;\n private readonly batchMs: number;\n private readonly maxBufferSize: number;\n private readonly transport: HttpTransport;\n\n constructor(opts: QueueOptions) {\n this.batchSize = opts.batchSize ?? DEFAULT_BATCH_SIZE;\n this.batchMs = opts.batchMs ?? DEFAULT_BATCH_MS;\n this.maxBufferSize = opts.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE;\n this.transport = opts.transport;\n }\n\n start(): void {\n if (this.timer) {\n return;\n }\n\n this.timer = setInterval(() => {\n this.flush();\n }, this.batchMs);\n\n if (typeof globalThis.addEventListener === \"function\") {\n globalThis.addEventListener(\"visibilitychange\", this.onVisibilityChange);\n globalThis.addEventListener(\"beforeunload\", this.onBeforeUnload);\n }\n }\n\n enqueue(envelope: Envelope): void {\n this.buffer.push(envelope);\n\n if (this.buffer.length > this.maxBufferSize) {\n const overflow = this.buffer.length - this.maxBufferSize;\n this.buffer.splice(0, overflow);\n log.warn(\"buffer full, dropped %d oldest envelopes\", overflow);\n }\n\n if (this.buffer.length >= this.batchSize) {\n this.flush();\n }\n }\n\n flush(): void {\n if (this.flushing || this.buffer.length === 0) {\n return;\n }\n\n if (this.failures >= BREAKER_THRESHOLD && Date.now() < this.pausedUntil) {\n return;\n }\n\n this.flushing = true;\n const batch = this.buffer.splice(0, this.batchSize);\n\n this.transport\n .send(batch)\n .then(() => {\n if (this.failures > 0) {\n log.info(\"send recovered after %d failures\", this.failures);\n }\n this.failures = 0;\n })\n .catch(() => {\n if (!hasServiceWorker()) {\n this.buffer.unshift(...batch);\n }\n this.failures++;\n if (this.failures >= BREAKER_THRESHOLD) {\n this.pausedUntil = Date.now() + BREAKER_COOLDOWN_MS;\n log.warn(\n \"pausing sends for %dms after %d consecutive failures\",\n BREAKER_COOLDOWN_MS,\n this.failures\n );\n }\n })\n .finally(() => {\n this.flushing = false;\n });\n }\n\n dispose(): void {\n if (this.timer) {\n clearInterval(this.timer);\n this.timer = null;\n }\n\n if (typeof globalThis.removeEventListener === \"function\") {\n globalThis.removeEventListener(\n \"visibilitychange\",\n this.onVisibilityChange\n );\n globalThis.removeEventListener(\"beforeunload\", this.onBeforeUnload);\n }\n\n this.drain();\n }\n\n private drain(): void {\n while (this.buffer.length > 0) {\n const batch = this.buffer.splice(0, this.batchSize);\n this.transport.send(batch).catch(() => {\n /* best-effort — SW BackgroundSync handles persistence */\n });\n }\n }\n\n private readonly onVisibilityChange = (): void => {\n if (document.visibilityState === \"hidden\") {\n this.drain();\n }\n };\n\n private readonly onBeforeUnload = (): void => {\n this.drain();\n };\n}\n"],"mappings":";;;AAKA,MAAM,MAAM,aAAa,QAAQ;AAEjC,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;AACzB,MAAM,0BAA0B;AAEhC,MAAM,oBAAoB;AAC1B,MAAM,sBAAsB;AAS5B,IAAa,aAAb,MAAwB;CACtB,SAAsC,EAAE;CACxC,QAAuD;CACvD,WAAmB;CACnB,WAAmB;CACnB,cAAsB;CACtB;CACA;CACA;CACA;CAEA,YAAY,MAAoB;AAC9B,OAAK,YAAY,KAAK,aAAa;AACnC,OAAK,UAAU,KAAK,WAAW;AAC/B,OAAK,gBAAgB,KAAK,iBAAiB;AAC3C,OAAK,YAAY,KAAK;;CAGxB,QAAc;AACZ,MAAI,KAAK,MACP;AAGF,OAAK,QAAQ,kBAAkB;AAC7B,QAAK,OAAO;KACX,KAAK,QAAQ;AAEhB,MAAI,OAAO,WAAW,qBAAqB,YAAY;AACrD,cAAW,iBAAiB,oBAAoB,KAAK,mBAAmB;AACxE,cAAW,iBAAiB,gBAAgB,KAAK,eAAe;;;CAIpE,QAAQ,UAA0B;AAChC,OAAK,OAAO,KAAK,SAAS;AAE1B,MAAI,KAAK,OAAO,SAAS,KAAK,eAAe;GAC3C,MAAM,WAAW,KAAK,OAAO,SAAS,KAAK;AAC3C,QAAK,OAAO,OAAO,GAAG,SAAS;AAC/B,OAAI,KAAK,4CAA4C,SAAS;;AAGhE,MAAI,KAAK,OAAO,UAAU,KAAK,UAC7B,MAAK,OAAO;;CAIhB,QAAc;AACZ,MAAI,KAAK,YAAY,KAAK,OAAO,WAAW,EAC1C;AAGF,MAAI,KAAK,YAAY,qBAAqB,KAAK,KAAK,GAAG,KAAK,YAC1D;AAGF,OAAK,WAAW;EAChB,MAAM,QAAQ,KAAK,OAAO,OAAO,GAAG,KAAK,UAAU;AAEnD,OAAK,UACF,KAAK,MAAM,CACX,WAAW;AACV,OAAI,KAAK,WAAW,EAClB,KAAI,KAAK,oCAAoC,KAAK,SAAS;AAE7D,QAAK,WAAW;IAChB,CACD,YAAY;AACX,OAAI,CAAC,kBAAkB,CACrB,MAAK,OAAO,QAAQ,GAAG,MAAM;AAE/B,QAAK;AACL,OAAI,KAAK,YAAY,mBAAmB;AACtC,SAAK,cAAc,KAAK,KAAK,GAAG;AAChC,QAAI,KACF,wDACA,qBACA,KAAK,SACN;;IAEH,CACD,cAAc;AACb,QAAK,WAAW;IAChB;;CAGN,UAAgB;AACd,MAAI,KAAK,OAAO;AACd,iBAAc,KAAK,MAAM;AACzB,QAAK,QAAQ;;AAGf,MAAI,OAAO,WAAW,wBAAwB,YAAY;AACxD,cAAW,oBACT,oBACA,KAAK,mBACN;AACD,cAAW,oBAAoB,gBAAgB,KAAK,eAAe;;AAGrE,OAAK,OAAO;;CAGd,QAAsB;AACpB,SAAO,KAAK,OAAO,SAAS,GAAG;GAC7B,MAAM,QAAQ,KAAK,OAAO,OAAO,GAAG,KAAK,UAAU;AACnD,QAAK,UAAU,KAAK,MAAM,CAAC,YAAY,GAErC;;;CAIN,2BAAkD;AAChD,MAAI,SAAS,oBAAoB,SAC/B,MAAK,OAAO;;CAIhB,uBAA8C;AAC5C,OAAK,OAAO"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
//#region src/util/log.d.ts
|
|
2
|
+
type LogLevel = "debug" | "info" | "warn" | "error" | "none";
|
|
3
|
+
declare function setLogLevel(level: LogLevel): void;
|
|
4
|
+
declare function getLogLevel(): LogLevel;
|
|
5
|
+
interface Logger {
|
|
6
|
+
debug(...args: unknown[]): void;
|
|
7
|
+
error(...args: unknown[]): void;
|
|
8
|
+
info(...args: unknown[]): void;
|
|
9
|
+
warn(...args: unknown[]): void;
|
|
10
|
+
}
|
|
11
|
+
declare function createLogger(scope: string): Logger;
|
|
12
|
+
//#endregion
|
|
13
|
+
export { LogLevel, Logger, createLogger, getLogLevel, setLogLevel };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"log.d.mts","names":[],"sources":["../../src/util/log.ts"],"mappings":";KAAY,QAAA;AAAA,iBAsBI,WAAA,CAAY,KAAA,EAAO,QAAA;AAAA,iBAInB,WAAA,CAAA,GAAe,QAAA;AAAA,UAKd,MAAA;EACf,KAAA,IAAS,IAAA;EACT,KAAA,IAAS,IAAA;EACT,IAAA,IAAQ,IAAA;EACR,IAAA,IAAQ,IAAA;AAAA;AAAA,iBAeM,YAAA,CAAa,KAAA,WAAgB,MAAA"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
//#region src/util/log.ts
|
|
2
|
+
const PRIORITY = {
|
|
3
|
+
debug: 0,
|
|
4
|
+
info: 1,
|
|
5
|
+
warn: 2,
|
|
6
|
+
error: 3,
|
|
7
|
+
none: 4
|
|
8
|
+
};
|
|
9
|
+
const CONSOLE_FN = {
|
|
10
|
+
debug: "debug",
|
|
11
|
+
info: "info",
|
|
12
|
+
warn: "warn",
|
|
13
|
+
error: "error"
|
|
14
|
+
};
|
|
15
|
+
let threshold = PRIORITY.warn;
|
|
16
|
+
function setLogLevel(level) {
|
|
17
|
+
threshold = PRIORITY[level];
|
|
18
|
+
}
|
|
19
|
+
function getLogLevel() {
|
|
20
|
+
return Object.entries(PRIORITY).find(([, v]) => v === threshold)?.[0] ?? "warn";
|
|
21
|
+
}
|
|
22
|
+
function emit(level, prefix, args) {
|
|
23
|
+
if (PRIORITY[level] < threshold) return;
|
|
24
|
+
const fn = CONSOLE_FN[level];
|
|
25
|
+
globalThis.console[fn](prefix, ...args);
|
|
26
|
+
}
|
|
27
|
+
function createLogger(scope) {
|
|
28
|
+
const prefix = `[Interfere:${scope}]`;
|
|
29
|
+
return {
|
|
30
|
+
debug: (...args) => emit("debug", prefix, args),
|
|
31
|
+
info: (...args) => emit("info", prefix, args),
|
|
32
|
+
warn: (...args) => emit("warn", prefix, args),
|
|
33
|
+
error: (...args) => emit("error", prefix, args)
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
//#endregion
|
|
37
|
+
export { createLogger, getLogLevel, setLogLevel };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"log.mjs","names":[],"sources":["../../src/util/log.ts"],"sourcesContent":["export type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"none\";\n\nconst PRIORITY: Record<LogLevel, number> = {\n debug: 0,\n info: 1,\n warn: 2,\n error: 3,\n none: 4,\n};\n\nconst CONSOLE_FN: Record<\n Exclude<LogLevel, \"none\">,\n \"debug\" | \"info\" | \"warn\" | \"error\"\n> = {\n debug: \"debug\",\n info: \"info\",\n warn: \"warn\",\n error: \"error\",\n};\n\nlet threshold = PRIORITY.warn;\n\nexport function setLogLevel(level: LogLevel): void {\n threshold = PRIORITY[level];\n}\n\nexport function getLogLevel(): LogLevel {\n const entry = Object.entries(PRIORITY).find(([, v]) => v === threshold);\n return (entry?.[0] ?? \"warn\") as LogLevel;\n}\n\nexport interface Logger {\n debug(...args: unknown[]): void;\n error(...args: unknown[]): void;\n info(...args: unknown[]): void;\n warn(...args: unknown[]): void;\n}\n\nfunction emit(\n level: Exclude<LogLevel, \"none\">,\n prefix: string,\n args: unknown[]\n): void {\n if (PRIORITY[level] < threshold) {\n return;\n }\n const fn = CONSOLE_FN[level];\n globalThis.console[fn](prefix, ...args);\n}\n\nexport function createLogger(scope: string): Logger {\n const prefix = `[Interfere:${scope}]`;\n return {\n debug: (...args) => emit(\"debug\", prefix, args),\n info: (...args) => emit(\"info\", prefix, args),\n warn: (...args) => emit(\"warn\", prefix, args),\n error: (...args) => emit(\"error\", prefix, args),\n };\n}\n"],"mappings":";AAEA,MAAM,WAAqC;CACzC,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,MAAM;CACP;AAED,MAAM,aAGF;CACF,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACR;AAED,IAAI,YAAY,SAAS;AAEzB,SAAgB,YAAY,OAAuB;AACjD,aAAY,SAAS;;AAGvB,SAAgB,cAAwB;AAEtC,QADc,OAAO,QAAQ,SAAS,CAAC,MAAM,GAAG,OAAO,MAAM,UAAU,GACvD,MAAM;;AAUxB,SAAS,KACP,OACA,QACA,MACM;AACN,KAAI,SAAS,SAAS,UACpB;CAEF,MAAM,KAAK,WAAW;AACtB,YAAW,QAAQ,IAAI,QAAQ,GAAG,KAAK;;AAGzC,SAAgB,aAAa,OAAuB;CAClD,MAAM,SAAS,cAAc,MAAM;AACnC,QAAO;EACL,QAAQ,GAAG,SAAS,KAAK,SAAS,QAAQ,KAAK;EAC/C,OAAO,GAAG,SAAS,KAAK,QAAQ,QAAQ,KAAK;EAC7C,OAAO,GAAG,SAAS,KAAK,QAAQ,QAAQ,KAAK;EAC7C,QAAQ,GAAG,SAAS,KAAK,SAAS,QAAQ,KAAK;EAChD"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@interfere/react",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "4.0.0",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"description": "Client-side React SDK for Interfere. Error tracking, session replay, and analytics.",
|
|
6
6
|
"keywords": [
|
|
@@ -54,34 +54,34 @@
|
|
|
54
54
|
"test": "bun run test:unit && bun run test:browser"
|
|
55
55
|
},
|
|
56
56
|
"dependencies": {
|
|
57
|
-
"@fingerprintjs/fingerprintjs-pro": "
|
|
58
|
-
"@interfere/constants": "
|
|
59
|
-
"@interfere/types": "
|
|
60
|
-
"@ua-parser-js/pro-enterprise": "
|
|
61
|
-
"rrweb": "
|
|
62
|
-
"tctx": "
|
|
63
|
-
"uuid": "
|
|
57
|
+
"@fingerprintjs/fingerprintjs-pro": "^3.12.8",
|
|
58
|
+
"@interfere/constants": "^4.0.0",
|
|
59
|
+
"@interfere/types": "^4.0.0",
|
|
60
|
+
"@ua-parser-js/pro-enterprise": "^2.0.6",
|
|
61
|
+
"rrweb": "2.0.0-alpha.4",
|
|
62
|
+
"tctx": "^0.2.5",
|
|
63
|
+
"uuid": "^13.0.0"
|
|
64
64
|
},
|
|
65
65
|
"peerDependencies": {
|
|
66
66
|
"react": ">=19",
|
|
67
67
|
"react-dom": ">=19"
|
|
68
68
|
},
|
|
69
69
|
"devDependencies": {
|
|
70
|
-
"@interfere/typescript-config": "
|
|
71
|
-
"@interfere/vitest-config": "
|
|
72
|
-
"@rrweb/types": "
|
|
73
|
-
"@testing-library/react": "
|
|
74
|
-
"@types/node": "
|
|
75
|
-
"@types/react": "
|
|
76
|
-
"@types/react-dom": "
|
|
77
|
-
"@vitejs/plugin-react": "
|
|
78
|
-
"@vitest/browser": "
|
|
79
|
-
"@vitest/browser-playwright": "
|
|
80
|
-
"@vitest/coverage-v8": "
|
|
81
|
-
"jsdom": "
|
|
82
|
-
"playwright": "
|
|
83
|
-
"tsdown": "
|
|
84
|
-
"typescript": "
|
|
85
|
-
"vitest": "
|
|
70
|
+
"@interfere/typescript-config": "^4.0.0",
|
|
71
|
+
"@interfere/vitest-config": "^4.0.0",
|
|
72
|
+
"@rrweb/types": "2.0.0-alpha.20",
|
|
73
|
+
"@testing-library/react": "^16.3.2",
|
|
74
|
+
"@types/node": "^24.12.0",
|
|
75
|
+
"@types/react": "19.2.14",
|
|
76
|
+
"@types/react-dom": "19.2.3",
|
|
77
|
+
"@vitejs/plugin-react": "^6.0.1",
|
|
78
|
+
"@vitest/browser": "4.1.0",
|
|
79
|
+
"@vitest/browser-playwright": "4.1.0",
|
|
80
|
+
"@vitest/coverage-v8": "^4.0.18",
|
|
81
|
+
"jsdom": "^29.0.0",
|
|
82
|
+
"playwright": "^1.56.1",
|
|
83
|
+
"tsdown": "^0.21.3",
|
|
84
|
+
"typescript": "5.9.3",
|
|
85
|
+
"vitest": "^4.0.18"
|
|
86
86
|
}
|
|
87
87
|
}
|