@plasius/analytics 1.0.0 → 1.1.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/README.md +29 -4
- package/dist/index.cjs +193 -47
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +29 -3
- package/dist/index.d.ts +29 -3
- package/dist/index.js +191 -47
- package/dist/index.js.map +1 -1
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -14,6 +14,7 @@ Local-space analytics primitives for browser apps and reusable React components.
|
|
|
14
14
|
|
|
15
15
|
- Queue interaction events locally (in-memory + `localStorage` backup)
|
|
16
16
|
- Flush analytics batches to a configurable endpoint
|
|
17
|
+
- Support frontend and backend analytics channels simultaneously
|
|
17
18
|
- Browser-lifecycle flush support (`visibilitychange`, `pagehide`, `sendBeacon`)
|
|
18
19
|
- React provider and hooks for component-level event instrumentation
|
|
19
20
|
|
|
@@ -26,9 +27,12 @@ npm install @plasius/analytics
|
|
|
26
27
|
## Core API
|
|
27
28
|
|
|
28
29
|
```ts
|
|
29
|
-
import {
|
|
30
|
+
import {
|
|
31
|
+
createBackendAnalyticsClient,
|
|
32
|
+
createFrontendAnalyticsClient,
|
|
33
|
+
} from "@plasius/analytics";
|
|
30
34
|
|
|
31
|
-
const
|
|
35
|
+
const frontendAnalytics = createFrontendAnalyticsClient({
|
|
32
36
|
source: "sharedcomponents",
|
|
33
37
|
endpoint: "https://analytics.example.com/collect",
|
|
34
38
|
defaultContext: {
|
|
@@ -36,7 +40,12 @@ const analytics = createLocalSpaceAnalyticsClient({
|
|
|
36
40
|
},
|
|
37
41
|
});
|
|
38
42
|
|
|
39
|
-
|
|
43
|
+
const backendAnalytics = createBackendAnalyticsClient({
|
|
44
|
+
source: "plasius-ltd-site-api",
|
|
45
|
+
endpoint: "https://analytics.example.com/collect",
|
|
46
|
+
});
|
|
47
|
+
|
|
48
|
+
frontendAnalytics.track({
|
|
40
49
|
component: "Header",
|
|
41
50
|
action: "nav_click",
|
|
42
51
|
label: "About",
|
|
@@ -46,7 +55,15 @@ analytics.track({
|
|
|
46
55
|
},
|
|
47
56
|
});
|
|
48
57
|
|
|
49
|
-
|
|
58
|
+
backendAnalytics.track({
|
|
59
|
+
component: "VideoWorker",
|
|
60
|
+
action: "job_completed",
|
|
61
|
+
requestId: "req-123",
|
|
62
|
+
context: { worker: "render" },
|
|
63
|
+
});
|
|
64
|
+
|
|
65
|
+
await frontendAnalytics.flush();
|
|
66
|
+
await backendAnalytics.flush();
|
|
50
67
|
```
|
|
51
68
|
|
|
52
69
|
## React API
|
|
@@ -75,6 +92,7 @@ function SaveButton() {
|
|
|
75
92
|
<AnalyticsProvider
|
|
76
93
|
source="sharedcomponents"
|
|
77
94
|
endpoint="https://analytics.example.com/collect"
|
|
95
|
+
channel="frontend"
|
|
78
96
|
>
|
|
79
97
|
<SaveButton />
|
|
80
98
|
</AnalyticsProvider>;
|
|
@@ -87,19 +105,26 @@ function SaveButton() {
|
|
|
87
105
|
```json
|
|
88
106
|
{
|
|
89
107
|
"source": "sharedcomponents",
|
|
108
|
+
"channel": "frontend",
|
|
109
|
+
"runtime": "browser",
|
|
90
110
|
"sentAt": 1735300000000,
|
|
91
111
|
"events": [
|
|
92
112
|
{
|
|
93
113
|
"id": "event_xxx",
|
|
94
114
|
"source": "sharedcomponents",
|
|
115
|
+
"channel": "frontend",
|
|
116
|
+
"runtime": "browser",
|
|
95
117
|
"sessionId": "session_xxx",
|
|
96
118
|
"timestamp": 1735300000000,
|
|
97
119
|
"component": "Header",
|
|
98
120
|
"action": "nav_click",
|
|
121
|
+
"requestId": "req-123",
|
|
99
122
|
"label": "About",
|
|
100
123
|
"href": "/about",
|
|
101
124
|
"variant": "desktop",
|
|
102
125
|
"context": {
|
|
126
|
+
"analyticsChannel": "frontend",
|
|
127
|
+
"analyticsRuntime": "browser",
|
|
103
128
|
"application": "white-label-portal",
|
|
104
129
|
"feature": "navigation"
|
|
105
130
|
}
|
package/dist/index.cjs
CHANGED
|
@@ -21,6 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
|
|
|
21
21
|
var index_exports = {};
|
|
22
22
|
__export(index_exports, {
|
|
23
23
|
AnalyticsProvider: () => AnalyticsProvider,
|
|
24
|
+
createBackendAnalyticsClient: () => createBackendAnalyticsClient,
|
|
25
|
+
createFrontendAnalyticsClient: () => createFrontendAnalyticsClient,
|
|
24
26
|
createLocalSpaceAnalyticsClient: () => createLocalSpaceAnalyticsClient,
|
|
25
27
|
createNoopLocalSpaceAnalyticsClient: () => createNoopLocalSpaceAnalyticsClient,
|
|
26
28
|
useAnalytics: () => useAnalytics,
|
|
@@ -32,11 +34,54 @@ module.exports = __toCommonJS(index_exports);
|
|
|
32
34
|
var DEFAULT_FLUSH_INTERVAL_MS = 5e3;
|
|
33
35
|
var DEFAULT_BATCH_SIZE = 20;
|
|
34
36
|
var DEFAULT_MAX_QUEUE_SIZE = 500;
|
|
35
|
-
var
|
|
37
|
+
var DEFAULT_STORAGE_KEY_PREFIX = "plasius.analytics.local-space.queue";
|
|
36
38
|
var JSON_CONTENT_TYPE_HEADER = "application/json";
|
|
37
39
|
function createId(prefix) {
|
|
38
40
|
return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
|
|
39
41
|
}
|
|
42
|
+
function isBrowserEnvironment() {
|
|
43
|
+
return typeof window !== "undefined" && typeof document !== "undefined";
|
|
44
|
+
}
|
|
45
|
+
function resolveRuntime(explicitRuntime, previousRuntime) {
|
|
46
|
+
if (explicitRuntime) {
|
|
47
|
+
return explicitRuntime;
|
|
48
|
+
}
|
|
49
|
+
if (previousRuntime) {
|
|
50
|
+
return previousRuntime;
|
|
51
|
+
}
|
|
52
|
+
return isBrowserEnvironment() ? "browser" : "server";
|
|
53
|
+
}
|
|
54
|
+
function resolveChannel(explicitChannel, runtime, previousChannel) {
|
|
55
|
+
if (explicitChannel) {
|
|
56
|
+
return explicitChannel;
|
|
57
|
+
}
|
|
58
|
+
if (previousChannel) {
|
|
59
|
+
return previousChannel;
|
|
60
|
+
}
|
|
61
|
+
return runtime === "server" ? "backend" : "frontend";
|
|
62
|
+
}
|
|
63
|
+
function sanitizeStorageSourceSegment(source) {
|
|
64
|
+
const normalized = source.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-");
|
|
65
|
+
return normalized || "unknown-source";
|
|
66
|
+
}
|
|
67
|
+
function buildDefaultStorageKey(source, channel) {
|
|
68
|
+
return `${DEFAULT_STORAGE_KEY_PREFIX}.${channel}.${sanitizeStorageSourceSegment(source)}`;
|
|
69
|
+
}
|
|
70
|
+
function resolveStorageKey(configStorageKey, source, channel, previous) {
|
|
71
|
+
const explicitStorageKey = configStorageKey?.trim();
|
|
72
|
+
if (explicitStorageKey) {
|
|
73
|
+
return explicitStorageKey;
|
|
74
|
+
}
|
|
75
|
+
const defaultStorageKey = buildDefaultStorageKey(source, channel);
|
|
76
|
+
if (!previous) {
|
|
77
|
+
return defaultStorageKey;
|
|
78
|
+
}
|
|
79
|
+
const previousDefaultStorageKey = buildDefaultStorageKey(
|
|
80
|
+
previous.source,
|
|
81
|
+
previous.channel
|
|
82
|
+
);
|
|
83
|
+
return previous.storageKey === previousDefaultStorageKey ? defaultStorageKey : previous.storageKey;
|
|
84
|
+
}
|
|
40
85
|
async function defaultTransport({
|
|
41
86
|
endpoint,
|
|
42
87
|
body,
|
|
@@ -63,14 +108,32 @@ function toPositiveInteger(value, fallback) {
|
|
|
63
108
|
const rounded = Math.floor(value);
|
|
64
109
|
return rounded > 0 ? rounded : fallback;
|
|
65
110
|
}
|
|
111
|
+
function resolveSessionId(configSessionId, previousSessionId) {
|
|
112
|
+
const explicitSessionId = configSessionId?.trim();
|
|
113
|
+
if (explicitSessionId) {
|
|
114
|
+
return explicitSessionId;
|
|
115
|
+
}
|
|
116
|
+
if (previousSessionId) {
|
|
117
|
+
return previousSessionId;
|
|
118
|
+
}
|
|
119
|
+
return createId("session");
|
|
120
|
+
}
|
|
66
121
|
function resolveConfig(config, previous) {
|
|
67
122
|
const source = (config.source ?? previous?.source ?? "").trim();
|
|
68
123
|
if (!source) {
|
|
69
124
|
throw new Error("Local space analytics requires a non-empty source.");
|
|
70
125
|
}
|
|
126
|
+
const runtime = resolveRuntime(config.runtime, previous?.runtime);
|
|
127
|
+
const channel = resolveChannel(config.channel, runtime, previous?.channel);
|
|
128
|
+
const endpointCandidate = config.endpoint !== void 0 ? config.endpoint : previous?.endpoint;
|
|
129
|
+
const endpoint = endpointCandidate?.trim() || void 0;
|
|
71
130
|
return {
|
|
72
131
|
source,
|
|
73
|
-
endpoint
|
|
132
|
+
endpoint,
|
|
133
|
+
channel,
|
|
134
|
+
runtime,
|
|
135
|
+
sessionId: resolveSessionId(config.sessionId, previous?.sessionId),
|
|
136
|
+
injectChannelContext: config.injectChannelContext ?? previous?.injectChannelContext ?? true,
|
|
74
137
|
enabled: config.enabled ?? previous?.enabled ?? true,
|
|
75
138
|
defaultContext: {
|
|
76
139
|
...previous?.defaultContext ?? {},
|
|
@@ -90,15 +153,30 @@ function resolveConfig(config, previous) {
|
|
|
90
153
|
config.maxQueueSize ?? previous?.maxQueueSize,
|
|
91
154
|
DEFAULT_MAX_QUEUE_SIZE
|
|
92
155
|
),
|
|
93
|
-
storageKey: (config.storageKey
|
|
156
|
+
storageKey: resolveStorageKey(config.storageKey, source, channel, previous),
|
|
94
157
|
transport: config.transport ?? previous?.transport ?? defaultTransport,
|
|
95
158
|
onError: config.onError ?? previous?.onError
|
|
96
159
|
};
|
|
97
160
|
}
|
|
98
|
-
function
|
|
99
|
-
|
|
161
|
+
function isStoredRecordCandidate(value) {
|
|
162
|
+
if (!value || typeof value !== "object") {
|
|
163
|
+
return false;
|
|
164
|
+
}
|
|
165
|
+
const candidate = value;
|
|
166
|
+
return typeof candidate.id === "string" && typeof candidate.component === "string" && typeof candidate.action === "string" && typeof candidate.source === "string" && typeof candidate.sessionId === "string" && typeof candidate.timestamp === "number";
|
|
167
|
+
}
|
|
168
|
+
function normalizeStoredRecord(value, fallbackConfig) {
|
|
169
|
+
const context = value.context && typeof value.context === "object" && !Array.isArray(value.context) ? value.context : {};
|
|
170
|
+
const channel = value.channel === "frontend" || value.channel === "backend" ? value.channel : fallbackConfig.channel;
|
|
171
|
+
const runtime = value.runtime === "browser" || value.runtime === "server" ? value.runtime : fallbackConfig.runtime;
|
|
172
|
+
return {
|
|
173
|
+
...value,
|
|
174
|
+
channel,
|
|
175
|
+
runtime,
|
|
176
|
+
context
|
|
177
|
+
};
|
|
100
178
|
}
|
|
101
|
-
function readQueue(storageKey) {
|
|
179
|
+
function readQueue(storageKey, fallbackConfig) {
|
|
102
180
|
if (!isBrowserEnvironment() || typeof window.localStorage === "undefined") {
|
|
103
181
|
return [];
|
|
104
182
|
}
|
|
@@ -111,18 +189,11 @@ function readQueue(storageKey) {
|
|
|
111
189
|
if (!Array.isArray(parsed)) {
|
|
112
190
|
return [];
|
|
113
191
|
}
|
|
114
|
-
return parsed.filter(isStoredRecordCandidate);
|
|
192
|
+
return parsed.filter(isStoredRecordCandidate).map((record) => normalizeStoredRecord(record, fallbackConfig));
|
|
115
193
|
} catch {
|
|
116
194
|
return [];
|
|
117
195
|
}
|
|
118
196
|
}
|
|
119
|
-
function isStoredRecordCandidate(value) {
|
|
120
|
-
if (!value || typeof value !== "object") {
|
|
121
|
-
return false;
|
|
122
|
-
}
|
|
123
|
-
const candidate = value;
|
|
124
|
-
return typeof candidate.id === "string" && typeof candidate.component === "string" && typeof candidate.action === "string" && typeof candidate.source === "string" && typeof candidate.sessionId === "string" && typeof candidate.timestamp === "number";
|
|
125
|
-
}
|
|
126
197
|
function writeQueue(storageKey, queue) {
|
|
127
198
|
if (!isBrowserEnvironment() || typeof window.localStorage === "undefined") {
|
|
128
199
|
return;
|
|
@@ -136,17 +207,35 @@ function writeQueue(storageKey, queue) {
|
|
|
136
207
|
} catch {
|
|
137
208
|
}
|
|
138
209
|
}
|
|
139
|
-
function createPayload(
|
|
210
|
+
function createPayload(config, events) {
|
|
140
211
|
return JSON.stringify({
|
|
141
|
-
source,
|
|
212
|
+
source: config.source,
|
|
213
|
+
channel: config.channel,
|
|
214
|
+
runtime: config.runtime,
|
|
142
215
|
sentAt: Date.now(),
|
|
143
216
|
events
|
|
144
217
|
});
|
|
145
218
|
}
|
|
219
|
+
function createMergedContext(config, eventChannel, eventContext) {
|
|
220
|
+
const mergedContext = {
|
|
221
|
+
...config.defaultContext,
|
|
222
|
+
...eventContext ?? {}
|
|
223
|
+
};
|
|
224
|
+
if (config.injectChannelContext) {
|
|
225
|
+
if (mergedContext.analyticsChannel === void 0) {
|
|
226
|
+
mergedContext.analyticsChannel = eventChannel;
|
|
227
|
+
}
|
|
228
|
+
if (mergedContext.analyticsRuntime === void 0) {
|
|
229
|
+
mergedContext.analyticsRuntime = config.runtime;
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
return mergedContext;
|
|
233
|
+
}
|
|
146
234
|
function createLocalSpaceAnalyticsClient(config) {
|
|
147
235
|
let resolvedConfig = resolveConfig(config);
|
|
148
|
-
|
|
149
|
-
|
|
236
|
+
let queue = readQueue(resolvedConfig.storageKey, resolvedConfig).slice(
|
|
237
|
+
-resolvedConfig.maxQueueSize
|
|
238
|
+
);
|
|
150
239
|
let flushTimer = null;
|
|
151
240
|
let isFlushing = false;
|
|
152
241
|
let flushQueuedAfterCurrent = false;
|
|
@@ -167,7 +256,7 @@ function createLocalSpaceAnalyticsClient(config) {
|
|
|
167
256
|
}
|
|
168
257
|
const events = queue.slice(0, resolvedConfig.batchSize);
|
|
169
258
|
try {
|
|
170
|
-
const body = createPayload(resolvedConfig
|
|
259
|
+
const body = createPayload(resolvedConfig, events);
|
|
171
260
|
const blob = new Blob([body], { type: JSON_CONTENT_TYPE_HEADER });
|
|
172
261
|
const sent = navigator.sendBeacon(resolvedConfig.endpoint, blob);
|
|
173
262
|
if (sent) {
|
|
@@ -191,7 +280,7 @@ function createLocalSpaceAnalyticsClient(config) {
|
|
|
191
280
|
return;
|
|
192
281
|
}
|
|
193
282
|
const events = queue.slice(0, resolvedConfig.batchSize);
|
|
194
|
-
const body = createPayload(resolvedConfig
|
|
283
|
+
const body = createPayload(resolvedConfig, events);
|
|
195
284
|
isFlushing = true;
|
|
196
285
|
try {
|
|
197
286
|
await resolvedConfig.transport({
|
|
@@ -247,35 +336,54 @@ function createLocalSpaceAnalyticsClient(config) {
|
|
|
247
336
|
window.addEventListener("pagehide", handlePageHide);
|
|
248
337
|
}
|
|
249
338
|
startFlushTimer();
|
|
339
|
+
const trackWithChannel = (event, channel) => {
|
|
340
|
+
const trackableEvent = {
|
|
341
|
+
...event,
|
|
342
|
+
channel
|
|
343
|
+
};
|
|
344
|
+
track(trackableEvent);
|
|
345
|
+
};
|
|
346
|
+
const track = (event) => {
|
|
347
|
+
if (isDestroyed || !resolvedConfig.enabled) {
|
|
348
|
+
return;
|
|
349
|
+
}
|
|
350
|
+
const eventChannel = event.channel ?? resolvedConfig.channel;
|
|
351
|
+
const requestId = typeof event.requestId === "string" && event.requestId.trim() ? event.requestId.trim() : void 0;
|
|
352
|
+
const record = {
|
|
353
|
+
id: createId("event"),
|
|
354
|
+
component: event.component,
|
|
355
|
+
action: event.action,
|
|
356
|
+
channel: eventChannel,
|
|
357
|
+
runtime: resolvedConfig.runtime,
|
|
358
|
+
label: event.label,
|
|
359
|
+
href: event.href,
|
|
360
|
+
variant: event.variant,
|
|
361
|
+
requestId,
|
|
362
|
+
source: resolvedConfig.source,
|
|
363
|
+
sessionId: resolvedConfig.sessionId,
|
|
364
|
+
timestamp: event.timestamp ?? Date.now(),
|
|
365
|
+
context: createMergedContext(resolvedConfig, eventChannel, event.context)
|
|
366
|
+
};
|
|
367
|
+
queue.push(record);
|
|
368
|
+
trimQueue();
|
|
369
|
+
persistQueue();
|
|
370
|
+
if (queue.length >= resolvedConfig.batchSize) {
|
|
371
|
+
void flush();
|
|
372
|
+
}
|
|
373
|
+
};
|
|
250
374
|
return {
|
|
251
375
|
get source() {
|
|
252
376
|
return resolvedConfig.source;
|
|
253
377
|
},
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
href: event.href,
|
|
264
|
-
variant: event.variant,
|
|
265
|
-
source: resolvedConfig.source,
|
|
266
|
-
sessionId,
|
|
267
|
-
timestamp: event.timestamp ?? Date.now(),
|
|
268
|
-
context: {
|
|
269
|
-
...resolvedConfig.defaultContext,
|
|
270
|
-
...event.context ?? {}
|
|
271
|
-
}
|
|
272
|
-
};
|
|
273
|
-
queue.push(record);
|
|
274
|
-
trimQueue();
|
|
275
|
-
persistQueue();
|
|
276
|
-
if (queue.length >= resolvedConfig.batchSize) {
|
|
277
|
-
void flush();
|
|
278
|
-
}
|
|
378
|
+
get channel() {
|
|
379
|
+
return resolvedConfig.channel;
|
|
380
|
+
},
|
|
381
|
+
track,
|
|
382
|
+
trackFrontend(event) {
|
|
383
|
+
trackWithChannel(event, "frontend");
|
|
384
|
+
},
|
|
385
|
+
trackBackend(event) {
|
|
386
|
+
trackWithChannel(event, "backend");
|
|
279
387
|
},
|
|
280
388
|
flush,
|
|
281
389
|
updateConfig(nextConfig) {
|
|
@@ -320,9 +428,28 @@ function createLocalSpaceAnalyticsClient(config) {
|
|
|
320
428
|
}
|
|
321
429
|
};
|
|
322
430
|
}
|
|
323
|
-
function
|
|
431
|
+
function createFrontendAnalyticsClient(config) {
|
|
432
|
+
return createLocalSpaceAnalyticsClient({
|
|
433
|
+
...config,
|
|
434
|
+
channel: "frontend",
|
|
435
|
+
runtime: config.runtime ?? "browser"
|
|
436
|
+
});
|
|
437
|
+
}
|
|
438
|
+
function createBackendAnalyticsClient(config) {
|
|
439
|
+
return createLocalSpaceAnalyticsClient({
|
|
440
|
+
...config,
|
|
441
|
+
channel: "backend",
|
|
442
|
+
runtime: config.runtime ?? "server"
|
|
443
|
+
});
|
|
444
|
+
}
|
|
445
|
+
function createNoopLocalSpaceAnalyticsClient(source = "noop", channel = "frontend") {
|
|
446
|
+
const runtime = isBrowserEnvironment() ? "browser" : "server";
|
|
324
447
|
const noopConfig = {
|
|
325
448
|
source,
|
|
449
|
+
channel,
|
|
450
|
+
runtime,
|
|
451
|
+
sessionId: createId("session"),
|
|
452
|
+
injectChannelContext: true,
|
|
326
453
|
enabled: false,
|
|
327
454
|
endpoint: void 0,
|
|
328
455
|
defaultContext: {},
|
|
@@ -330,13 +457,16 @@ function createNoopLocalSpaceAnalyticsClient(source = "noop") {
|
|
|
330
457
|
flushIntervalMs: DEFAULT_FLUSH_INTERVAL_MS,
|
|
331
458
|
batchSize: DEFAULT_BATCH_SIZE,
|
|
332
459
|
maxQueueSize: DEFAULT_MAX_QUEUE_SIZE,
|
|
333
|
-
storageKey:
|
|
460
|
+
storageKey: buildDefaultStorageKey(source, channel),
|
|
334
461
|
transport: async () => void 0,
|
|
335
462
|
onError: void 0
|
|
336
463
|
};
|
|
337
464
|
return {
|
|
338
465
|
source,
|
|
466
|
+
channel,
|
|
339
467
|
track: () => void 0,
|
|
468
|
+
trackFrontend: () => void 0,
|
|
469
|
+
trackBackend: () => void 0,
|
|
340
470
|
flush: async () => void 0,
|
|
341
471
|
updateConfig: () => void 0,
|
|
342
472
|
getConfig: () => noopConfig,
|
|
@@ -352,6 +482,10 @@ function AnalyticsProvider({
|
|
|
352
482
|
children,
|
|
353
483
|
source = "react-app",
|
|
354
484
|
endpoint,
|
|
485
|
+
channel,
|
|
486
|
+
runtime,
|
|
487
|
+
sessionId,
|
|
488
|
+
injectChannelContext,
|
|
355
489
|
enabled = true,
|
|
356
490
|
defaultContext,
|
|
357
491
|
headers,
|
|
@@ -373,6 +507,10 @@ function AnalyticsProvider({
|
|
|
373
507
|
return createLocalSpaceAnalyticsClient({
|
|
374
508
|
source,
|
|
375
509
|
endpoint,
|
|
510
|
+
channel,
|
|
511
|
+
runtime,
|
|
512
|
+
sessionId,
|
|
513
|
+
injectChannelContext,
|
|
376
514
|
enabled,
|
|
377
515
|
defaultContext,
|
|
378
516
|
headers,
|
|
@@ -387,6 +525,10 @@ function AnalyticsProvider({
|
|
|
387
525
|
client,
|
|
388
526
|
source,
|
|
389
527
|
endpoint,
|
|
528
|
+
channel,
|
|
529
|
+
runtime,
|
|
530
|
+
sessionId,
|
|
531
|
+
injectChannelContext,
|
|
390
532
|
enabled,
|
|
391
533
|
defaultContext,
|
|
392
534
|
headers,
|
|
@@ -433,9 +575,11 @@ function useComponentInteractionTracker(component, baseContext = {}) {
|
|
|
433
575
|
trackInteraction({
|
|
434
576
|
component,
|
|
435
577
|
action,
|
|
578
|
+
channel: details?.channel,
|
|
436
579
|
label: details?.label,
|
|
437
580
|
href: details?.href,
|
|
438
581
|
variant: details?.variant,
|
|
582
|
+
requestId: details?.requestId,
|
|
439
583
|
timestamp: details?.timestamp,
|
|
440
584
|
context: {
|
|
441
585
|
...baseContext,
|
|
@@ -449,6 +593,8 @@ function useComponentInteractionTracker(component, baseContext = {}) {
|
|
|
449
593
|
// Annotate the CommonJS export names for ESM import in node:
|
|
450
594
|
0 && (module.exports = {
|
|
451
595
|
AnalyticsProvider,
|
|
596
|
+
createBackendAnalyticsClient,
|
|
597
|
+
createFrontendAnalyticsClient,
|
|
452
598
|
createLocalSpaceAnalyticsClient,
|
|
453
599
|
createNoopLocalSpaceAnalyticsClient,
|
|
454
600
|
useAnalytics,
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../src/core/client.ts","../src/react/provider.tsx","../src/react/hooks.ts"],"sourcesContent":["export * from \"./core/index.js\";\nexport * from \"./react/index.js\";\n","import type {\n AnalyticsTransport,\n LocalSpaceAnalyticsClient,\n LocalSpaceAnalyticsConfig,\n LocalSpaceAnalyticsEvent,\n LocalSpaceAnalyticsRecord,\n ResolvedLocalSpaceAnalyticsConfig,\n} from \"./types.js\";\n\nconst DEFAULT_FLUSH_INTERVAL_MS = 5000;\nconst DEFAULT_BATCH_SIZE = 20;\nconst DEFAULT_MAX_QUEUE_SIZE = 500;\nconst DEFAULT_STORAGE_KEY = \"plasius.analytics.local-space.queue\";\n\nconst JSON_CONTENT_TYPE_HEADER = \"application/json\";\n\nfunction createId(prefix: string): string {\n return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nasync function defaultTransport({\n endpoint,\n body,\n headers,\n keepalive,\n}: {\n endpoint: string;\n body: string;\n headers: Record<string, string>;\n keepalive: boolean;\n}): Promise<void> {\n if (typeof fetch !== \"function\") {\n return;\n }\n\n const response = await fetch(endpoint, {\n method: \"POST\",\n headers,\n body,\n keepalive,\n });\n\n if (!response.ok) {\n throw new Error(`Analytics transport failed with status ${response.status}.`);\n }\n}\n\nfunction toPositiveInteger(value: number | undefined, fallback: number): number {\n if (typeof value !== \"number\" || !Number.isFinite(value)) {\n return fallback;\n }\n\n const rounded = Math.floor(value);\n return rounded > 0 ? rounded : fallback;\n}\n\nfunction resolveConfig(\n config: LocalSpaceAnalyticsConfig,\n previous?: ResolvedLocalSpaceAnalyticsConfig\n): ResolvedLocalSpaceAnalyticsConfig {\n const source = (config.source ?? previous?.source ?? \"\").trim();\n\n if (!source) {\n throw new Error(\"Local space analytics requires a non-empty source.\");\n }\n\n return {\n source,\n endpoint: config.endpoint?.trim(),\n enabled: config.enabled ?? previous?.enabled ?? true,\n defaultContext: {\n ...(previous?.defaultContext ?? {}),\n ...(config.defaultContext ?? {}),\n },\n headers: {\n \"content-type\": JSON_CONTENT_TYPE_HEADER,\n ...(previous?.headers ?? {}),\n ...(config.headers ?? {}),\n },\n flushIntervalMs: toPositiveInteger(\n config.flushIntervalMs ?? previous?.flushIntervalMs,\n DEFAULT_FLUSH_INTERVAL_MS\n ),\n batchSize: toPositiveInteger(config.batchSize ?? previous?.batchSize, DEFAULT_BATCH_SIZE),\n maxQueueSize: toPositiveInteger(\n config.maxQueueSize ?? previous?.maxQueueSize,\n DEFAULT_MAX_QUEUE_SIZE\n ),\n storageKey: (config.storageKey ?? previous?.storageKey ?? DEFAULT_STORAGE_KEY).trim(),\n transport: (config.transport ?? previous?.transport ?? defaultTransport) as AnalyticsTransport,\n onError: config.onError ?? previous?.onError,\n };\n}\n\nfunction isBrowserEnvironment(): boolean {\n return typeof window !== \"undefined\" && typeof document !== \"undefined\";\n}\n\nfunction readQueue(storageKey: string): LocalSpaceAnalyticsRecord[] {\n if (!isBrowserEnvironment() || typeof window.localStorage === \"undefined\") {\n return [];\n }\n\n try {\n const rawValue = window.localStorage.getItem(storageKey);\n if (!rawValue) {\n return [];\n }\n\n const parsed = JSON.parse(rawValue);\n if (!Array.isArray(parsed)) {\n return [];\n }\n\n return parsed.filter(isStoredRecordCandidate);\n } catch {\n return [];\n }\n}\n\nfunction isStoredRecordCandidate(value: unknown): value is LocalSpaceAnalyticsRecord {\n if (!value || typeof value !== \"object\") {\n return false;\n }\n\n const candidate = value as Partial<LocalSpaceAnalyticsRecord>;\n return (\n typeof candidate.id === \"string\" &&\n typeof candidate.component === \"string\" &&\n typeof candidate.action === \"string\" &&\n typeof candidate.source === \"string\" &&\n typeof candidate.sessionId === \"string\" &&\n typeof candidate.timestamp === \"number\"\n );\n}\n\nfunction writeQueue(storageKey: string, queue: LocalSpaceAnalyticsRecord[]): void {\n if (!isBrowserEnvironment() || typeof window.localStorage === \"undefined\") {\n return;\n }\n\n try {\n if (queue.length === 0) {\n window.localStorage.removeItem(storageKey);\n return;\n }\n\n window.localStorage.setItem(storageKey, JSON.stringify(queue));\n } catch {\n // Ignored by design: storage quota errors should never break host app UX.\n }\n}\n\nfunction createPayload(source: string, events: LocalSpaceAnalyticsRecord[]): string {\n return JSON.stringify({\n source,\n sentAt: Date.now(),\n events,\n });\n}\n\nexport function createLocalSpaceAnalyticsClient(\n config: LocalSpaceAnalyticsConfig\n): LocalSpaceAnalyticsClient {\n let resolvedConfig = resolveConfig(config);\n const sessionId = createId(\"session\");\n let queue = readQueue(resolvedConfig.storageKey).slice(-resolvedConfig.maxQueueSize);\n\n let flushTimer: ReturnType<typeof setInterval> | null = null;\n let isFlushing = false;\n let flushQueuedAfterCurrent = false;\n let isDestroyed = false;\n\n const persistQueue = () => writeQueue(resolvedConfig.storageKey, queue);\n\n const trimQueue = () => {\n if (queue.length <= resolvedConfig.maxQueueSize) {\n return;\n }\n\n queue = queue.slice(queue.length - resolvedConfig.maxQueueSize);\n };\n\n const flushWithBeacon = (): boolean => {\n if (!resolvedConfig.endpoint || queue.length === 0) {\n return false;\n }\n\n if (\n typeof navigator === \"undefined\" ||\n typeof navigator.sendBeacon !== \"function\"\n ) {\n return false;\n }\n\n const events = queue.slice(0, resolvedConfig.batchSize);\n\n try {\n const body = createPayload(resolvedConfig.source, events);\n const blob = new Blob([body], { type: JSON_CONTENT_TYPE_HEADER });\n const sent = navigator.sendBeacon(resolvedConfig.endpoint, blob);\n\n if (sent) {\n queue = queue.slice(events.length);\n persistQueue();\n }\n\n return sent;\n } catch {\n return false;\n }\n };\n\n const flush = async (): Promise<void> => {\n if (isDestroyed || !resolvedConfig.enabled || !resolvedConfig.endpoint) {\n return;\n }\n\n if (queue.length === 0) {\n return;\n }\n\n if (isFlushing) {\n flushQueuedAfterCurrent = true;\n return;\n }\n\n const events = queue.slice(0, resolvedConfig.batchSize);\n const body = createPayload(resolvedConfig.source, events);\n\n isFlushing = true;\n\n try {\n await resolvedConfig.transport({\n endpoint: resolvedConfig.endpoint,\n body,\n headers: resolvedConfig.headers,\n keepalive: true,\n });\n\n queue = queue.slice(events.length);\n persistQueue();\n } catch (error) {\n resolvedConfig.onError?.(error);\n } finally {\n isFlushing = false;\n\n if (flushQueuedAfterCurrent) {\n flushQueuedAfterCurrent = false;\n if (queue.length > 0) {\n void flush();\n }\n }\n }\n };\n\n const startFlushTimer = () => {\n if (flushTimer) {\n clearInterval(flushTimer);\n flushTimer = null;\n }\n\n if (!resolvedConfig.enabled) {\n return;\n }\n\n flushTimer = setInterval(() => {\n void flush();\n }, resolvedConfig.flushIntervalMs);\n };\n\n const handleVisibilityChange = () => {\n if (typeof document === \"undefined\") {\n return;\n }\n\n if (document.visibilityState !== \"hidden\") {\n return;\n }\n\n if (!flushWithBeacon()) {\n void flush();\n }\n };\n\n const handlePageHide = () => {\n if (!flushWithBeacon()) {\n void flush();\n }\n };\n\n if (isBrowserEnvironment()) {\n document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n window.addEventListener(\"pagehide\", handlePageHide);\n }\n\n startFlushTimer();\n\n return {\n get source() {\n return resolvedConfig.source;\n },\n\n track(event: LocalSpaceAnalyticsEvent) {\n if (isDestroyed || !resolvedConfig.enabled) {\n return;\n }\n\n const record: LocalSpaceAnalyticsRecord = {\n id: createId(\"event\"),\n component: event.component,\n action: event.action,\n label: event.label,\n href: event.href,\n variant: event.variant,\n source: resolvedConfig.source,\n sessionId,\n timestamp: event.timestamp ?? Date.now(),\n context: {\n ...resolvedConfig.defaultContext,\n ...(event.context ?? {}),\n },\n };\n\n queue.push(record);\n trimQueue();\n persistQueue();\n\n if (queue.length >= resolvedConfig.batchSize) {\n void flush();\n }\n },\n\n flush,\n\n updateConfig(nextConfig: Partial<LocalSpaceAnalyticsConfig>) {\n if (isDestroyed) {\n return;\n }\n\n const previousStorageKey = resolvedConfig.storageKey;\n resolvedConfig = resolveConfig(\n {\n ...resolvedConfig,\n ...nextConfig,\n source: nextConfig.source ?? resolvedConfig.source,\n },\n resolvedConfig\n );\n\n if (previousStorageKey !== resolvedConfig.storageKey) {\n writeQueue(previousStorageKey, []);\n persistQueue();\n }\n\n startFlushTimer();\n\n if (resolvedConfig.endpoint && queue.length > 0) {\n void flush();\n }\n },\n\n getConfig() {\n return resolvedConfig;\n },\n\n destroy() {\n if (isDestroyed) {\n return;\n }\n\n isDestroyed = true;\n\n if (flushTimer) {\n clearInterval(flushTimer);\n flushTimer = null;\n }\n\n if (isBrowserEnvironment()) {\n document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n window.removeEventListener(\"pagehide\", handlePageHide);\n }\n\n void flush();\n },\n };\n}\n\nexport function createNoopLocalSpaceAnalyticsClient(\n source = \"noop\"\n): LocalSpaceAnalyticsClient {\n const noopConfig: ResolvedLocalSpaceAnalyticsConfig = {\n source,\n enabled: false,\n endpoint: undefined,\n defaultContext: {},\n headers: { \"content-type\": JSON_CONTENT_TYPE_HEADER },\n flushIntervalMs: DEFAULT_FLUSH_INTERVAL_MS,\n batchSize: DEFAULT_BATCH_SIZE,\n maxQueueSize: DEFAULT_MAX_QUEUE_SIZE,\n storageKey: DEFAULT_STORAGE_KEY,\n transport: async () => undefined,\n onError: undefined,\n };\n\n return {\n source,\n track: () => undefined,\n flush: async () => undefined,\n updateConfig: () => undefined,\n getConfig: () => noopConfig,\n destroy: () => undefined,\n };\n}\n","import { createContext, useContext, useEffect, useMemo, type ReactNode } from \"react\";\nimport {\n createLocalSpaceAnalyticsClient,\n createNoopLocalSpaceAnalyticsClient,\n} from \"../core/client.js\";\nimport type {\n LocalSpaceAnalyticsClient,\n LocalSpaceAnalyticsConfig,\n LocalSpaceAnalyticsEvent,\n} from \"../core/types.js\";\n\nexport interface AnalyticsProviderProps {\n children: ReactNode;\n source?: string;\n endpoint?: string;\n enabled?: boolean;\n defaultContext?: LocalSpaceAnalyticsConfig[\"defaultContext\"];\n headers?: LocalSpaceAnalyticsConfig[\"headers\"];\n flushIntervalMs?: number;\n batchSize?: number;\n maxQueueSize?: number;\n storageKey?: string;\n transport?: LocalSpaceAnalyticsConfig[\"transport\"];\n onError?: LocalSpaceAnalyticsConfig[\"onError\"];\n client?: LocalSpaceAnalyticsClient;\n}\n\nexport interface AnalyticsContextValue {\n client: LocalSpaceAnalyticsClient;\n trackInteraction: (event: LocalSpaceAnalyticsEvent) => void;\n flush: () => Promise<void>;\n}\n\nconst AnalyticsContext = createContext<AnalyticsContextValue | null>(null);\n\nexport function AnalyticsProvider({\n children,\n source = \"react-app\",\n endpoint,\n enabled = true,\n defaultContext,\n headers,\n flushIntervalMs,\n batchSize,\n maxQueueSize,\n storageKey,\n transport,\n onError,\n client,\n}: AnalyticsProviderProps) {\n const managedClient = useMemo(() => {\n if (client) {\n return client;\n }\n\n if (!enabled) {\n return createNoopLocalSpaceAnalyticsClient(source);\n }\n\n return createLocalSpaceAnalyticsClient({\n source,\n endpoint,\n enabled,\n defaultContext,\n headers,\n flushIntervalMs,\n batchSize,\n maxQueueSize,\n storageKey,\n transport,\n onError,\n });\n }, [\n client,\n source,\n endpoint,\n enabled,\n defaultContext,\n headers,\n flushIntervalMs,\n batchSize,\n maxQueueSize,\n storageKey,\n transport,\n onError,\n ]);\n\n useEffect(() => {\n return () => {\n if (!client) {\n managedClient.destroy();\n }\n };\n }, [client, managedClient]);\n\n const value = useMemo<AnalyticsContextValue>(\n () => ({\n client: managedClient,\n trackInteraction: (event: LocalSpaceAnalyticsEvent) => {\n managedClient.track(event);\n },\n flush: () => managedClient.flush(),\n }),\n [managedClient]\n );\n\n return <AnalyticsContext.Provider value={value}>{children}</AnalyticsContext.Provider>;\n}\n\nexport function useAnalytics(): AnalyticsContextValue {\n const context = useContext(AnalyticsContext);\n\n if (!context) {\n throw new Error(\"useAnalytics must be used within AnalyticsProvider.\");\n }\n\n return context;\n}\n","import { useCallback } from \"react\";\nimport type { AnalyticsContext, LocalSpaceAnalyticsEvent } from \"../core/types.js\";\nimport { useAnalytics } from \"./provider.js\";\n\nexport interface TrackInteractionDetails\n extends Omit<LocalSpaceAnalyticsEvent, \"component\" | \"action\" | \"context\"> {\n context?: AnalyticsContext;\n}\n\nexport function useComponentInteractionTracker(\n component: string,\n baseContext: AnalyticsContext = {}\n): (action: string, details?: TrackInteractionDetails) => void {\n const { trackInteraction } = useAnalytics();\n\n return useCallback(\n (action: string, details?: TrackInteractionDetails) => {\n trackInteraction({\n component,\n action,\n label: details?.label,\n href: details?.href,\n variant: details?.variant,\n timestamp: details?.timestamp,\n context: {\n ...baseContext,\n ...(details?.context ?? {}),\n },\n });\n },\n [baseContext, component, trackInteraction]\n );\n}\n"],"mappings":"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","names":["import_react"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/core/client.ts","../src/react/provider.tsx","../src/react/hooks.ts"],"sourcesContent":["export * from \"./core/index.js\";\nexport * from \"./react/index.js\";\n","import type {\n AnalyticsChannel,\n AnalyticsContext,\n AnalyticsRuntime,\n AnalyticsTransport,\n LocalSpaceAnalyticsClient,\n LocalSpaceAnalyticsConfig,\n LocalSpaceAnalyticsEvent,\n LocalSpaceAnalyticsRecord,\n ResolvedLocalSpaceAnalyticsConfig,\n} from \"./types.js\";\n\nconst DEFAULT_FLUSH_INTERVAL_MS = 5000;\nconst DEFAULT_BATCH_SIZE = 20;\nconst DEFAULT_MAX_QUEUE_SIZE = 500;\nconst DEFAULT_STORAGE_KEY_PREFIX = \"plasius.analytics.local-space.queue\";\n\nconst JSON_CONTENT_TYPE_HEADER = \"application/json\";\n\nfunction createId(prefix: string): string {\n return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction isBrowserEnvironment(): boolean {\n return typeof window !== \"undefined\" && typeof document !== \"undefined\";\n}\n\nfunction resolveRuntime(\n explicitRuntime: AnalyticsRuntime | undefined,\n previousRuntime: AnalyticsRuntime | undefined\n): AnalyticsRuntime {\n if (explicitRuntime) {\n return explicitRuntime;\n }\n\n if (previousRuntime) {\n return previousRuntime;\n }\n\n return isBrowserEnvironment() ? \"browser\" : \"server\";\n}\n\nfunction resolveChannel(\n explicitChannel: AnalyticsChannel | undefined,\n runtime: AnalyticsRuntime,\n previousChannel: AnalyticsChannel | undefined\n): AnalyticsChannel {\n if (explicitChannel) {\n return explicitChannel;\n }\n\n if (previousChannel) {\n return previousChannel;\n }\n\n return runtime === \"server\" ? \"backend\" : \"frontend\";\n}\n\nfunction sanitizeStorageSourceSegment(source: string): string {\n const normalized = source.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, \"-\");\n return normalized || \"unknown-source\";\n}\n\nfunction buildDefaultStorageKey(source: string, channel: AnalyticsChannel): string {\n return `${DEFAULT_STORAGE_KEY_PREFIX}.${channel}.${sanitizeStorageSourceSegment(source)}`;\n}\n\nfunction resolveStorageKey(\n configStorageKey: string | undefined,\n source: string,\n channel: AnalyticsChannel,\n previous?: ResolvedLocalSpaceAnalyticsConfig\n): string {\n const explicitStorageKey = configStorageKey?.trim();\n if (explicitStorageKey) {\n return explicitStorageKey;\n }\n\n const defaultStorageKey = buildDefaultStorageKey(source, channel);\n if (!previous) {\n return defaultStorageKey;\n }\n\n const previousDefaultStorageKey = buildDefaultStorageKey(\n previous.source,\n previous.channel\n );\n\n return previous.storageKey === previousDefaultStorageKey\n ? defaultStorageKey\n : previous.storageKey;\n}\n\nasync function defaultTransport({\n endpoint,\n body,\n headers,\n keepalive,\n}: {\n endpoint: string;\n body: string;\n headers: Record<string, string>;\n keepalive: boolean;\n}): Promise<void> {\n if (typeof fetch !== \"function\") {\n return;\n }\n\n const response = await fetch(endpoint, {\n method: \"POST\",\n headers,\n body,\n keepalive,\n });\n\n if (!response.ok) {\n throw new Error(`Analytics transport failed with status ${response.status}.`);\n }\n}\n\nfunction toPositiveInteger(value: number | undefined, fallback: number): number {\n if (typeof value !== \"number\" || !Number.isFinite(value)) {\n return fallback;\n }\n\n const rounded = Math.floor(value);\n return rounded > 0 ? rounded : fallback;\n}\n\nfunction resolveSessionId(\n configSessionId: string | undefined,\n previousSessionId: string | undefined\n): string {\n const explicitSessionId = configSessionId?.trim();\n if (explicitSessionId) {\n return explicitSessionId;\n }\n\n if (previousSessionId) {\n return previousSessionId;\n }\n\n return createId(\"session\");\n}\n\nfunction resolveConfig(\n config: LocalSpaceAnalyticsConfig,\n previous?: ResolvedLocalSpaceAnalyticsConfig\n): ResolvedLocalSpaceAnalyticsConfig {\n const source = (config.source ?? previous?.source ?? \"\").trim();\n if (!source) {\n throw new Error(\"Local space analytics requires a non-empty source.\");\n }\n\n const runtime = resolveRuntime(config.runtime, previous?.runtime);\n const channel = resolveChannel(config.channel, runtime, previous?.channel);\n\n const endpointCandidate =\n config.endpoint !== undefined ? config.endpoint : previous?.endpoint;\n const endpoint = endpointCandidate?.trim() || undefined;\n\n return {\n source,\n endpoint,\n channel,\n runtime,\n sessionId: resolveSessionId(config.sessionId, previous?.sessionId),\n injectChannelContext:\n config.injectChannelContext ?? previous?.injectChannelContext ?? true,\n enabled: config.enabled ?? previous?.enabled ?? true,\n defaultContext: {\n ...(previous?.defaultContext ?? {}),\n ...(config.defaultContext ?? {}),\n },\n headers: {\n \"content-type\": JSON_CONTENT_TYPE_HEADER,\n ...(previous?.headers ?? {}),\n ...(config.headers ?? {}),\n },\n flushIntervalMs: toPositiveInteger(\n config.flushIntervalMs ?? previous?.flushIntervalMs,\n DEFAULT_FLUSH_INTERVAL_MS\n ),\n batchSize: toPositiveInteger(config.batchSize ?? previous?.batchSize, DEFAULT_BATCH_SIZE),\n maxQueueSize: toPositiveInteger(\n config.maxQueueSize ?? previous?.maxQueueSize,\n DEFAULT_MAX_QUEUE_SIZE\n ),\n storageKey: resolveStorageKey(config.storageKey, source, channel, previous),\n transport: (config.transport ?? previous?.transport ?? defaultTransport) as AnalyticsTransport,\n onError: config.onError ?? previous?.onError,\n };\n}\n\nfunction isStoredRecordCandidate(value: unknown): value is LocalSpaceAnalyticsRecord {\n if (!value || typeof value !== \"object\") {\n return false;\n }\n\n const candidate = value as Partial<LocalSpaceAnalyticsRecord>;\n return (\n typeof candidate.id === \"string\" &&\n typeof candidate.component === \"string\" &&\n typeof candidate.action === \"string\" &&\n typeof candidate.source === \"string\" &&\n typeof candidate.sessionId === \"string\" &&\n typeof candidate.timestamp === \"number\"\n );\n}\n\nfunction normalizeStoredRecord(\n value: LocalSpaceAnalyticsRecord,\n fallbackConfig: ResolvedLocalSpaceAnalyticsConfig\n): LocalSpaceAnalyticsRecord {\n const context =\n value.context && typeof value.context === \"object\" && !Array.isArray(value.context)\n ? value.context\n : {};\n\n const channel: AnalyticsChannel =\n value.channel === \"frontend\" || value.channel === \"backend\"\n ? value.channel\n : fallbackConfig.channel;\n\n const runtime: AnalyticsRuntime =\n value.runtime === \"browser\" || value.runtime === \"server\"\n ? value.runtime\n : fallbackConfig.runtime;\n\n return {\n ...value,\n channel,\n runtime,\n context,\n };\n}\n\nfunction readQueue(\n storageKey: string,\n fallbackConfig: ResolvedLocalSpaceAnalyticsConfig\n): LocalSpaceAnalyticsRecord[] {\n if (!isBrowserEnvironment() || typeof window.localStorage === \"undefined\") {\n return [];\n }\n\n try {\n const rawValue = window.localStorage.getItem(storageKey);\n if (!rawValue) {\n return [];\n }\n\n const parsed = JSON.parse(rawValue);\n if (!Array.isArray(parsed)) {\n return [];\n }\n\n return parsed\n .filter(isStoredRecordCandidate)\n .map((record) => normalizeStoredRecord(record, fallbackConfig));\n } catch {\n return [];\n }\n}\n\nfunction writeQueue(storageKey: string, queue: LocalSpaceAnalyticsRecord[]): void {\n if (!isBrowserEnvironment() || typeof window.localStorage === \"undefined\") {\n return;\n }\n\n try {\n if (queue.length === 0) {\n window.localStorage.removeItem(storageKey);\n return;\n }\n\n window.localStorage.setItem(storageKey, JSON.stringify(queue));\n } catch {\n // Ignored by design: storage quota errors should never break host app UX.\n }\n}\n\nfunction createPayload(config: ResolvedLocalSpaceAnalyticsConfig, events: LocalSpaceAnalyticsRecord[]): string {\n return JSON.stringify({\n source: config.source,\n channel: config.channel,\n runtime: config.runtime,\n sentAt: Date.now(),\n events,\n });\n}\n\nfunction createMergedContext(\n config: ResolvedLocalSpaceAnalyticsConfig,\n eventChannel: AnalyticsChannel,\n eventContext: AnalyticsContext | undefined\n): AnalyticsContext {\n const mergedContext: AnalyticsContext = {\n ...config.defaultContext,\n ...(eventContext ?? {}),\n };\n\n if (config.injectChannelContext) {\n if (mergedContext.analyticsChannel === undefined) {\n mergedContext.analyticsChannel = eventChannel;\n }\n if (mergedContext.analyticsRuntime === undefined) {\n mergedContext.analyticsRuntime = config.runtime;\n }\n }\n\n return mergedContext;\n}\n\nexport function createLocalSpaceAnalyticsClient(\n config: LocalSpaceAnalyticsConfig\n): LocalSpaceAnalyticsClient {\n let resolvedConfig = resolveConfig(config);\n let queue = readQueue(resolvedConfig.storageKey, resolvedConfig).slice(\n -resolvedConfig.maxQueueSize\n );\n\n let flushTimer: ReturnType<typeof setInterval> | null = null;\n let isFlushing = false;\n let flushQueuedAfterCurrent = false;\n let isDestroyed = false;\n\n const persistQueue = () => writeQueue(resolvedConfig.storageKey, queue);\n\n const trimQueue = () => {\n if (queue.length <= resolvedConfig.maxQueueSize) {\n return;\n }\n\n queue = queue.slice(queue.length - resolvedConfig.maxQueueSize);\n };\n\n const flushWithBeacon = (): boolean => {\n if (!resolvedConfig.endpoint || queue.length === 0) {\n return false;\n }\n\n if (\n typeof navigator === \"undefined\" ||\n typeof navigator.sendBeacon !== \"function\"\n ) {\n return false;\n }\n\n const events = queue.slice(0, resolvedConfig.batchSize);\n\n try {\n const body = createPayload(resolvedConfig, events);\n const blob = new Blob([body], { type: JSON_CONTENT_TYPE_HEADER });\n const sent = navigator.sendBeacon(resolvedConfig.endpoint, blob);\n\n if (sent) {\n queue = queue.slice(events.length);\n persistQueue();\n }\n\n return sent;\n } catch {\n return false;\n }\n };\n\n const flush = async (): Promise<void> => {\n if (isDestroyed || !resolvedConfig.enabled || !resolvedConfig.endpoint) {\n return;\n }\n\n if (queue.length === 0) {\n return;\n }\n\n if (isFlushing) {\n flushQueuedAfterCurrent = true;\n return;\n }\n\n const events = queue.slice(0, resolvedConfig.batchSize);\n const body = createPayload(resolvedConfig, events);\n\n isFlushing = true;\n\n try {\n await resolvedConfig.transport({\n endpoint: resolvedConfig.endpoint,\n body,\n headers: resolvedConfig.headers,\n keepalive: true,\n });\n\n queue = queue.slice(events.length);\n persistQueue();\n } catch (error) {\n resolvedConfig.onError?.(error);\n } finally {\n isFlushing = false;\n\n if (flushQueuedAfterCurrent) {\n flushQueuedAfterCurrent = false;\n if (queue.length > 0) {\n void flush();\n }\n }\n }\n };\n\n const startFlushTimer = () => {\n if (flushTimer) {\n clearInterval(flushTimer);\n flushTimer = null;\n }\n\n if (!resolvedConfig.enabled) {\n return;\n }\n\n flushTimer = setInterval(() => {\n void flush();\n }, resolvedConfig.flushIntervalMs);\n };\n\n const handleVisibilityChange = () => {\n if (typeof document === \"undefined\") {\n return;\n }\n\n if (document.visibilityState !== \"hidden\") {\n return;\n }\n\n if (!flushWithBeacon()) {\n void flush();\n }\n };\n\n const handlePageHide = () => {\n if (!flushWithBeacon()) {\n void flush();\n }\n };\n\n if (isBrowserEnvironment()) {\n document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n window.addEventListener(\"pagehide\", handlePageHide);\n }\n\n startFlushTimer();\n\n const trackWithChannel = (\n event: Omit<LocalSpaceAnalyticsEvent, \"channel\">,\n channel: AnalyticsChannel\n ) => {\n const trackableEvent: LocalSpaceAnalyticsEvent = {\n ...event,\n channel,\n };\n track(trackableEvent);\n };\n\n const track = (event: LocalSpaceAnalyticsEvent) => {\n if (isDestroyed || !resolvedConfig.enabled) {\n return;\n }\n\n const eventChannel = event.channel ?? resolvedConfig.channel;\n const requestId =\n typeof event.requestId === \"string\" && event.requestId.trim()\n ? event.requestId.trim()\n : undefined;\n\n const record: LocalSpaceAnalyticsRecord = {\n id: createId(\"event\"),\n component: event.component,\n action: event.action,\n channel: eventChannel,\n runtime: resolvedConfig.runtime,\n label: event.label,\n href: event.href,\n variant: event.variant,\n requestId,\n source: resolvedConfig.source,\n sessionId: resolvedConfig.sessionId,\n timestamp: event.timestamp ?? Date.now(),\n context: createMergedContext(resolvedConfig, eventChannel, event.context),\n };\n\n queue.push(record);\n trimQueue();\n persistQueue();\n\n if (queue.length >= resolvedConfig.batchSize) {\n void flush();\n }\n };\n\n return {\n get source() {\n return resolvedConfig.source;\n },\n\n get channel() {\n return resolvedConfig.channel;\n },\n\n track,\n\n trackFrontend(event) {\n trackWithChannel(event, \"frontend\");\n },\n\n trackBackend(event) {\n trackWithChannel(event, \"backend\");\n },\n\n flush,\n\n updateConfig(nextConfig: Partial<LocalSpaceAnalyticsConfig>) {\n if (isDestroyed) {\n return;\n }\n\n const previousStorageKey = resolvedConfig.storageKey;\n resolvedConfig = resolveConfig(\n {\n ...resolvedConfig,\n ...nextConfig,\n source: nextConfig.source ?? resolvedConfig.source,\n },\n resolvedConfig\n );\n\n if (previousStorageKey !== resolvedConfig.storageKey) {\n writeQueue(previousStorageKey, []);\n persistQueue();\n }\n\n startFlushTimer();\n\n if (resolvedConfig.endpoint && queue.length > 0) {\n void flush();\n }\n },\n\n getConfig() {\n return resolvedConfig;\n },\n\n destroy() {\n if (isDestroyed) {\n return;\n }\n\n isDestroyed = true;\n\n if (flushTimer) {\n clearInterval(flushTimer);\n flushTimer = null;\n }\n\n if (isBrowserEnvironment()) {\n document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n window.removeEventListener(\"pagehide\", handlePageHide);\n }\n\n void flush();\n },\n };\n}\n\ntype ChannelPinnedConfig = Omit<LocalSpaceAnalyticsConfig, \"channel\" | \"runtime\"> & {\n runtime?: AnalyticsRuntime;\n};\n\nexport function createFrontendAnalyticsClient(\n config: ChannelPinnedConfig\n): LocalSpaceAnalyticsClient {\n return createLocalSpaceAnalyticsClient({\n ...config,\n channel: \"frontend\",\n runtime: config.runtime ?? \"browser\",\n });\n}\n\nexport function createBackendAnalyticsClient(\n config: ChannelPinnedConfig\n): LocalSpaceAnalyticsClient {\n return createLocalSpaceAnalyticsClient({\n ...config,\n channel: \"backend\",\n runtime: config.runtime ?? \"server\",\n });\n}\n\nexport function createNoopLocalSpaceAnalyticsClient(\n source = \"noop\",\n channel: AnalyticsChannel = \"frontend\"\n): LocalSpaceAnalyticsClient {\n const runtime = isBrowserEnvironment() ? \"browser\" : \"server\";\n const noopConfig: ResolvedLocalSpaceAnalyticsConfig = {\n source,\n channel,\n runtime,\n sessionId: createId(\"session\"),\n injectChannelContext: true,\n enabled: false,\n endpoint: undefined,\n defaultContext: {},\n headers: { \"content-type\": JSON_CONTENT_TYPE_HEADER },\n flushIntervalMs: DEFAULT_FLUSH_INTERVAL_MS,\n batchSize: DEFAULT_BATCH_SIZE,\n maxQueueSize: DEFAULT_MAX_QUEUE_SIZE,\n storageKey: buildDefaultStorageKey(source, channel),\n transport: async () => undefined,\n onError: undefined,\n };\n\n return {\n source,\n channel,\n track: () => undefined,\n trackFrontend: () => undefined,\n trackBackend: () => undefined,\n flush: async () => undefined,\n updateConfig: () => undefined,\n getConfig: () => noopConfig,\n destroy: () => undefined,\n };\n}\n","import { createContext, useContext, useEffect, useMemo, type ReactNode } from \"react\";\nimport {\n createLocalSpaceAnalyticsClient,\n createNoopLocalSpaceAnalyticsClient,\n} from \"../core/client.js\";\nimport type {\n LocalSpaceAnalyticsClient,\n LocalSpaceAnalyticsConfig,\n LocalSpaceAnalyticsEvent,\n} from \"../core/types.js\";\n\nexport interface AnalyticsProviderProps {\n children: ReactNode;\n source?: string;\n endpoint?: string;\n channel?: LocalSpaceAnalyticsConfig[\"channel\"];\n runtime?: LocalSpaceAnalyticsConfig[\"runtime\"];\n sessionId?: string;\n injectChannelContext?: boolean;\n enabled?: boolean;\n defaultContext?: LocalSpaceAnalyticsConfig[\"defaultContext\"];\n headers?: LocalSpaceAnalyticsConfig[\"headers\"];\n flushIntervalMs?: number;\n batchSize?: number;\n maxQueueSize?: number;\n storageKey?: string;\n transport?: LocalSpaceAnalyticsConfig[\"transport\"];\n onError?: LocalSpaceAnalyticsConfig[\"onError\"];\n client?: LocalSpaceAnalyticsClient;\n}\n\nexport interface AnalyticsContextValue {\n client: LocalSpaceAnalyticsClient;\n trackInteraction: (event: LocalSpaceAnalyticsEvent) => void;\n flush: () => Promise<void>;\n}\n\nconst AnalyticsContext = createContext<AnalyticsContextValue | null>(null);\n\nexport function AnalyticsProvider({\n children,\n source = \"react-app\",\n endpoint,\n channel,\n runtime,\n sessionId,\n injectChannelContext,\n enabled = true,\n defaultContext,\n headers,\n flushIntervalMs,\n batchSize,\n maxQueueSize,\n storageKey,\n transport,\n onError,\n client,\n}: AnalyticsProviderProps) {\n const managedClient = useMemo(() => {\n if (client) {\n return client;\n }\n\n if (!enabled) {\n return createNoopLocalSpaceAnalyticsClient(source);\n }\n\n return createLocalSpaceAnalyticsClient({\n source,\n endpoint,\n channel,\n runtime,\n sessionId,\n injectChannelContext,\n enabled,\n defaultContext,\n headers,\n flushIntervalMs,\n batchSize,\n maxQueueSize,\n storageKey,\n transport,\n onError,\n });\n }, [\n client,\n source,\n endpoint,\n channel,\n runtime,\n sessionId,\n injectChannelContext,\n enabled,\n defaultContext,\n headers,\n flushIntervalMs,\n batchSize,\n maxQueueSize,\n storageKey,\n transport,\n onError,\n ]);\n\n useEffect(() => {\n return () => {\n if (!client) {\n managedClient.destroy();\n }\n };\n }, [client, managedClient]);\n\n const value = useMemo<AnalyticsContextValue>(\n () => ({\n client: managedClient,\n trackInteraction: (event: LocalSpaceAnalyticsEvent) => {\n managedClient.track(event);\n },\n flush: () => managedClient.flush(),\n }),\n [managedClient]\n );\n\n return <AnalyticsContext.Provider value={value}>{children}</AnalyticsContext.Provider>;\n}\n\nexport function useAnalytics(): AnalyticsContextValue {\n const context = useContext(AnalyticsContext);\n\n if (!context) {\n throw new Error(\"useAnalytics must be used within AnalyticsProvider.\");\n }\n\n return context;\n}\n","import { useCallback } from \"react\";\nimport type { AnalyticsContext, LocalSpaceAnalyticsEvent } from \"../core/types.js\";\nimport { useAnalytics } from \"./provider.js\";\n\nexport interface TrackInteractionDetails\n extends Omit<LocalSpaceAnalyticsEvent, \"component\" | \"action\" | \"context\"> {\n context?: AnalyticsContext;\n}\n\nexport function useComponentInteractionTracker(\n component: string,\n baseContext: AnalyticsContext = {}\n): (action: string, details?: TrackInteractionDetails) => void {\n const { trackInteraction } = useAnalytics();\n\n return useCallback(\n (action: string, details?: TrackInteractionDetails) => {\n trackInteraction({\n component,\n action,\n channel: details?.channel,\n label: details?.label,\n href: details?.href,\n variant: details?.variant,\n requestId: details?.requestId,\n timestamp: details?.timestamp,\n context: {\n ...baseContext,\n ...(details?.context ?? {}),\n },\n });\n },\n [baseContext, component, trackInteraction]\n );\n}\n"],"mappings":"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","names":["import_react"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -2,12 +2,16 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
|
|
|
2
2
|
import { ReactNode } from 'react';
|
|
3
3
|
|
|
4
4
|
type AnalyticsContext = Record<string, unknown>;
|
|
5
|
+
type AnalyticsChannel = "frontend" | "backend";
|
|
6
|
+
type AnalyticsRuntime = "browser" | "server";
|
|
5
7
|
interface LocalSpaceAnalyticsEvent {
|
|
6
8
|
component: string;
|
|
7
9
|
action: string;
|
|
10
|
+
channel?: AnalyticsChannel;
|
|
8
11
|
label?: string;
|
|
9
12
|
href?: string;
|
|
10
13
|
variant?: string;
|
|
14
|
+
requestId?: string;
|
|
11
15
|
context?: AnalyticsContext;
|
|
12
16
|
timestamp?: number;
|
|
13
17
|
}
|
|
@@ -15,6 +19,8 @@ interface LocalSpaceAnalyticsRecord extends LocalSpaceAnalyticsEvent {
|
|
|
15
19
|
id: string;
|
|
16
20
|
timestamp: number;
|
|
17
21
|
source: string;
|
|
22
|
+
channel: AnalyticsChannel;
|
|
23
|
+
runtime: AnalyticsRuntime;
|
|
18
24
|
sessionId: string;
|
|
19
25
|
context: AnalyticsContext;
|
|
20
26
|
}
|
|
@@ -28,6 +34,10 @@ type AnalyticsTransport = (request: AnalyticsTransportRequest) => Promise<void>;
|
|
|
28
34
|
interface LocalSpaceAnalyticsConfig {
|
|
29
35
|
endpoint?: string;
|
|
30
36
|
source: string;
|
|
37
|
+
channel?: AnalyticsChannel;
|
|
38
|
+
runtime?: AnalyticsRuntime;
|
|
39
|
+
sessionId?: string;
|
|
40
|
+
injectChannelContext?: boolean;
|
|
31
41
|
enabled?: boolean;
|
|
32
42
|
defaultContext?: AnalyticsContext;
|
|
33
43
|
headers?: Record<string, string>;
|
|
@@ -41,6 +51,10 @@ interface LocalSpaceAnalyticsConfig {
|
|
|
41
51
|
interface ResolvedLocalSpaceAnalyticsConfig {
|
|
42
52
|
endpoint?: string;
|
|
43
53
|
source: string;
|
|
54
|
+
channel: AnalyticsChannel;
|
|
55
|
+
runtime: AnalyticsRuntime;
|
|
56
|
+
sessionId: string;
|
|
57
|
+
injectChannelContext: boolean;
|
|
44
58
|
enabled: boolean;
|
|
45
59
|
defaultContext: AnalyticsContext;
|
|
46
60
|
headers: Record<string, string>;
|
|
@@ -53,7 +67,10 @@ interface ResolvedLocalSpaceAnalyticsConfig {
|
|
|
53
67
|
}
|
|
54
68
|
interface LocalSpaceAnalyticsClient {
|
|
55
69
|
readonly source: string;
|
|
70
|
+
readonly channel: AnalyticsChannel;
|
|
56
71
|
track: (event: LocalSpaceAnalyticsEvent) => void;
|
|
72
|
+
trackFrontend: (event: Omit<LocalSpaceAnalyticsEvent, "channel">) => void;
|
|
73
|
+
trackBackend: (event: Omit<LocalSpaceAnalyticsEvent, "channel">) => void;
|
|
57
74
|
flush: () => Promise<void>;
|
|
58
75
|
updateConfig: (config: Partial<LocalSpaceAnalyticsConfig>) => void;
|
|
59
76
|
getConfig: () => Readonly<ResolvedLocalSpaceAnalyticsConfig>;
|
|
@@ -61,12 +78,21 @@ interface LocalSpaceAnalyticsClient {
|
|
|
61
78
|
}
|
|
62
79
|
|
|
63
80
|
declare function createLocalSpaceAnalyticsClient(config: LocalSpaceAnalyticsConfig): LocalSpaceAnalyticsClient;
|
|
64
|
-
|
|
81
|
+
type ChannelPinnedConfig = Omit<LocalSpaceAnalyticsConfig, "channel" | "runtime"> & {
|
|
82
|
+
runtime?: AnalyticsRuntime;
|
|
83
|
+
};
|
|
84
|
+
declare function createFrontendAnalyticsClient(config: ChannelPinnedConfig): LocalSpaceAnalyticsClient;
|
|
85
|
+
declare function createBackendAnalyticsClient(config: ChannelPinnedConfig): LocalSpaceAnalyticsClient;
|
|
86
|
+
declare function createNoopLocalSpaceAnalyticsClient(source?: string, channel?: AnalyticsChannel): LocalSpaceAnalyticsClient;
|
|
65
87
|
|
|
66
88
|
interface AnalyticsProviderProps {
|
|
67
89
|
children: ReactNode;
|
|
68
90
|
source?: string;
|
|
69
91
|
endpoint?: string;
|
|
92
|
+
channel?: LocalSpaceAnalyticsConfig["channel"];
|
|
93
|
+
runtime?: LocalSpaceAnalyticsConfig["runtime"];
|
|
94
|
+
sessionId?: string;
|
|
95
|
+
injectChannelContext?: boolean;
|
|
70
96
|
enabled?: boolean;
|
|
71
97
|
defaultContext?: LocalSpaceAnalyticsConfig["defaultContext"];
|
|
72
98
|
headers?: LocalSpaceAnalyticsConfig["headers"];
|
|
@@ -83,7 +109,7 @@ interface AnalyticsContextValue {
|
|
|
83
109
|
trackInteraction: (event: LocalSpaceAnalyticsEvent) => void;
|
|
84
110
|
flush: () => Promise<void>;
|
|
85
111
|
}
|
|
86
|
-
declare function AnalyticsProvider({ children, source, endpoint, enabled, defaultContext, headers, flushIntervalMs, batchSize, maxQueueSize, storageKey, transport, onError, client, }: AnalyticsProviderProps): react_jsx_runtime.JSX.Element;
|
|
112
|
+
declare function AnalyticsProvider({ children, source, endpoint, channel, runtime, sessionId, injectChannelContext, enabled, defaultContext, headers, flushIntervalMs, batchSize, maxQueueSize, storageKey, transport, onError, client, }: AnalyticsProviderProps): react_jsx_runtime.JSX.Element;
|
|
87
113
|
declare function useAnalytics(): AnalyticsContextValue;
|
|
88
114
|
|
|
89
115
|
interface TrackInteractionDetails extends Omit<LocalSpaceAnalyticsEvent, "component" | "action" | "context"> {
|
|
@@ -91,4 +117,4 @@ interface TrackInteractionDetails extends Omit<LocalSpaceAnalyticsEvent, "compon
|
|
|
91
117
|
}
|
|
92
118
|
declare function useComponentInteractionTracker(component: string, baseContext?: AnalyticsContext): (action: string, details?: TrackInteractionDetails) => void;
|
|
93
119
|
|
|
94
|
-
export { type AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, type AnalyticsTransport, type AnalyticsTransportRequest, type LocalSpaceAnalyticsClient, type LocalSpaceAnalyticsConfig, type LocalSpaceAnalyticsEvent, type LocalSpaceAnalyticsRecord, type ResolvedLocalSpaceAnalyticsConfig, type TrackInteractionDetails, createLocalSpaceAnalyticsClient, createNoopLocalSpaceAnalyticsClient, useAnalytics, useComponentInteractionTracker };
|
|
120
|
+
export { type AnalyticsChannel, type AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, type AnalyticsRuntime, type AnalyticsTransport, type AnalyticsTransportRequest, type LocalSpaceAnalyticsClient, type LocalSpaceAnalyticsConfig, type LocalSpaceAnalyticsEvent, type LocalSpaceAnalyticsRecord, type ResolvedLocalSpaceAnalyticsConfig, type TrackInteractionDetails, createBackendAnalyticsClient, createFrontendAnalyticsClient, createLocalSpaceAnalyticsClient, createNoopLocalSpaceAnalyticsClient, useAnalytics, useComponentInteractionTracker };
|
package/dist/index.d.ts
CHANGED
|
@@ -2,12 +2,16 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
|
|
|
2
2
|
import { ReactNode } from 'react';
|
|
3
3
|
|
|
4
4
|
type AnalyticsContext = Record<string, unknown>;
|
|
5
|
+
type AnalyticsChannel = "frontend" | "backend";
|
|
6
|
+
type AnalyticsRuntime = "browser" | "server";
|
|
5
7
|
interface LocalSpaceAnalyticsEvent {
|
|
6
8
|
component: string;
|
|
7
9
|
action: string;
|
|
10
|
+
channel?: AnalyticsChannel;
|
|
8
11
|
label?: string;
|
|
9
12
|
href?: string;
|
|
10
13
|
variant?: string;
|
|
14
|
+
requestId?: string;
|
|
11
15
|
context?: AnalyticsContext;
|
|
12
16
|
timestamp?: number;
|
|
13
17
|
}
|
|
@@ -15,6 +19,8 @@ interface LocalSpaceAnalyticsRecord extends LocalSpaceAnalyticsEvent {
|
|
|
15
19
|
id: string;
|
|
16
20
|
timestamp: number;
|
|
17
21
|
source: string;
|
|
22
|
+
channel: AnalyticsChannel;
|
|
23
|
+
runtime: AnalyticsRuntime;
|
|
18
24
|
sessionId: string;
|
|
19
25
|
context: AnalyticsContext;
|
|
20
26
|
}
|
|
@@ -28,6 +34,10 @@ type AnalyticsTransport = (request: AnalyticsTransportRequest) => Promise<void>;
|
|
|
28
34
|
interface LocalSpaceAnalyticsConfig {
|
|
29
35
|
endpoint?: string;
|
|
30
36
|
source: string;
|
|
37
|
+
channel?: AnalyticsChannel;
|
|
38
|
+
runtime?: AnalyticsRuntime;
|
|
39
|
+
sessionId?: string;
|
|
40
|
+
injectChannelContext?: boolean;
|
|
31
41
|
enabled?: boolean;
|
|
32
42
|
defaultContext?: AnalyticsContext;
|
|
33
43
|
headers?: Record<string, string>;
|
|
@@ -41,6 +51,10 @@ interface LocalSpaceAnalyticsConfig {
|
|
|
41
51
|
interface ResolvedLocalSpaceAnalyticsConfig {
|
|
42
52
|
endpoint?: string;
|
|
43
53
|
source: string;
|
|
54
|
+
channel: AnalyticsChannel;
|
|
55
|
+
runtime: AnalyticsRuntime;
|
|
56
|
+
sessionId: string;
|
|
57
|
+
injectChannelContext: boolean;
|
|
44
58
|
enabled: boolean;
|
|
45
59
|
defaultContext: AnalyticsContext;
|
|
46
60
|
headers: Record<string, string>;
|
|
@@ -53,7 +67,10 @@ interface ResolvedLocalSpaceAnalyticsConfig {
|
|
|
53
67
|
}
|
|
54
68
|
interface LocalSpaceAnalyticsClient {
|
|
55
69
|
readonly source: string;
|
|
70
|
+
readonly channel: AnalyticsChannel;
|
|
56
71
|
track: (event: LocalSpaceAnalyticsEvent) => void;
|
|
72
|
+
trackFrontend: (event: Omit<LocalSpaceAnalyticsEvent, "channel">) => void;
|
|
73
|
+
trackBackend: (event: Omit<LocalSpaceAnalyticsEvent, "channel">) => void;
|
|
57
74
|
flush: () => Promise<void>;
|
|
58
75
|
updateConfig: (config: Partial<LocalSpaceAnalyticsConfig>) => void;
|
|
59
76
|
getConfig: () => Readonly<ResolvedLocalSpaceAnalyticsConfig>;
|
|
@@ -61,12 +78,21 @@ interface LocalSpaceAnalyticsClient {
|
|
|
61
78
|
}
|
|
62
79
|
|
|
63
80
|
declare function createLocalSpaceAnalyticsClient(config: LocalSpaceAnalyticsConfig): LocalSpaceAnalyticsClient;
|
|
64
|
-
|
|
81
|
+
type ChannelPinnedConfig = Omit<LocalSpaceAnalyticsConfig, "channel" | "runtime"> & {
|
|
82
|
+
runtime?: AnalyticsRuntime;
|
|
83
|
+
};
|
|
84
|
+
declare function createFrontendAnalyticsClient(config: ChannelPinnedConfig): LocalSpaceAnalyticsClient;
|
|
85
|
+
declare function createBackendAnalyticsClient(config: ChannelPinnedConfig): LocalSpaceAnalyticsClient;
|
|
86
|
+
declare function createNoopLocalSpaceAnalyticsClient(source?: string, channel?: AnalyticsChannel): LocalSpaceAnalyticsClient;
|
|
65
87
|
|
|
66
88
|
interface AnalyticsProviderProps {
|
|
67
89
|
children: ReactNode;
|
|
68
90
|
source?: string;
|
|
69
91
|
endpoint?: string;
|
|
92
|
+
channel?: LocalSpaceAnalyticsConfig["channel"];
|
|
93
|
+
runtime?: LocalSpaceAnalyticsConfig["runtime"];
|
|
94
|
+
sessionId?: string;
|
|
95
|
+
injectChannelContext?: boolean;
|
|
70
96
|
enabled?: boolean;
|
|
71
97
|
defaultContext?: LocalSpaceAnalyticsConfig["defaultContext"];
|
|
72
98
|
headers?: LocalSpaceAnalyticsConfig["headers"];
|
|
@@ -83,7 +109,7 @@ interface AnalyticsContextValue {
|
|
|
83
109
|
trackInteraction: (event: LocalSpaceAnalyticsEvent) => void;
|
|
84
110
|
flush: () => Promise<void>;
|
|
85
111
|
}
|
|
86
|
-
declare function AnalyticsProvider({ children, source, endpoint, enabled, defaultContext, headers, flushIntervalMs, batchSize, maxQueueSize, storageKey, transport, onError, client, }: AnalyticsProviderProps): react_jsx_runtime.JSX.Element;
|
|
112
|
+
declare function AnalyticsProvider({ children, source, endpoint, channel, runtime, sessionId, injectChannelContext, enabled, defaultContext, headers, flushIntervalMs, batchSize, maxQueueSize, storageKey, transport, onError, client, }: AnalyticsProviderProps): react_jsx_runtime.JSX.Element;
|
|
87
113
|
declare function useAnalytics(): AnalyticsContextValue;
|
|
88
114
|
|
|
89
115
|
interface TrackInteractionDetails extends Omit<LocalSpaceAnalyticsEvent, "component" | "action" | "context"> {
|
|
@@ -91,4 +117,4 @@ interface TrackInteractionDetails extends Omit<LocalSpaceAnalyticsEvent, "compon
|
|
|
91
117
|
}
|
|
92
118
|
declare function useComponentInteractionTracker(component: string, baseContext?: AnalyticsContext): (action: string, details?: TrackInteractionDetails) => void;
|
|
93
119
|
|
|
94
|
-
export { type AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, type AnalyticsTransport, type AnalyticsTransportRequest, type LocalSpaceAnalyticsClient, type LocalSpaceAnalyticsConfig, type LocalSpaceAnalyticsEvent, type LocalSpaceAnalyticsRecord, type ResolvedLocalSpaceAnalyticsConfig, type TrackInteractionDetails, createLocalSpaceAnalyticsClient, createNoopLocalSpaceAnalyticsClient, useAnalytics, useComponentInteractionTracker };
|
|
120
|
+
export { type AnalyticsChannel, type AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, type AnalyticsRuntime, type AnalyticsTransport, type AnalyticsTransportRequest, type LocalSpaceAnalyticsClient, type LocalSpaceAnalyticsConfig, type LocalSpaceAnalyticsEvent, type LocalSpaceAnalyticsRecord, type ResolvedLocalSpaceAnalyticsConfig, type TrackInteractionDetails, createBackendAnalyticsClient, createFrontendAnalyticsClient, createLocalSpaceAnalyticsClient, createNoopLocalSpaceAnalyticsClient, useAnalytics, useComponentInteractionTracker };
|
package/dist/index.js
CHANGED
|
@@ -2,11 +2,54 @@
|
|
|
2
2
|
var DEFAULT_FLUSH_INTERVAL_MS = 5e3;
|
|
3
3
|
var DEFAULT_BATCH_SIZE = 20;
|
|
4
4
|
var DEFAULT_MAX_QUEUE_SIZE = 500;
|
|
5
|
-
var
|
|
5
|
+
var DEFAULT_STORAGE_KEY_PREFIX = "plasius.analytics.local-space.queue";
|
|
6
6
|
var JSON_CONTENT_TYPE_HEADER = "application/json";
|
|
7
7
|
function createId(prefix) {
|
|
8
8
|
return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
|
|
9
9
|
}
|
|
10
|
+
function isBrowserEnvironment() {
|
|
11
|
+
return typeof window !== "undefined" && typeof document !== "undefined";
|
|
12
|
+
}
|
|
13
|
+
function resolveRuntime(explicitRuntime, previousRuntime) {
|
|
14
|
+
if (explicitRuntime) {
|
|
15
|
+
return explicitRuntime;
|
|
16
|
+
}
|
|
17
|
+
if (previousRuntime) {
|
|
18
|
+
return previousRuntime;
|
|
19
|
+
}
|
|
20
|
+
return isBrowserEnvironment() ? "browser" : "server";
|
|
21
|
+
}
|
|
22
|
+
function resolveChannel(explicitChannel, runtime, previousChannel) {
|
|
23
|
+
if (explicitChannel) {
|
|
24
|
+
return explicitChannel;
|
|
25
|
+
}
|
|
26
|
+
if (previousChannel) {
|
|
27
|
+
return previousChannel;
|
|
28
|
+
}
|
|
29
|
+
return runtime === "server" ? "backend" : "frontend";
|
|
30
|
+
}
|
|
31
|
+
function sanitizeStorageSourceSegment(source) {
|
|
32
|
+
const normalized = source.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-");
|
|
33
|
+
return normalized || "unknown-source";
|
|
34
|
+
}
|
|
35
|
+
function buildDefaultStorageKey(source, channel) {
|
|
36
|
+
return `${DEFAULT_STORAGE_KEY_PREFIX}.${channel}.${sanitizeStorageSourceSegment(source)}`;
|
|
37
|
+
}
|
|
38
|
+
function resolveStorageKey(configStorageKey, source, channel, previous) {
|
|
39
|
+
const explicitStorageKey = configStorageKey?.trim();
|
|
40
|
+
if (explicitStorageKey) {
|
|
41
|
+
return explicitStorageKey;
|
|
42
|
+
}
|
|
43
|
+
const defaultStorageKey = buildDefaultStorageKey(source, channel);
|
|
44
|
+
if (!previous) {
|
|
45
|
+
return defaultStorageKey;
|
|
46
|
+
}
|
|
47
|
+
const previousDefaultStorageKey = buildDefaultStorageKey(
|
|
48
|
+
previous.source,
|
|
49
|
+
previous.channel
|
|
50
|
+
);
|
|
51
|
+
return previous.storageKey === previousDefaultStorageKey ? defaultStorageKey : previous.storageKey;
|
|
52
|
+
}
|
|
10
53
|
async function defaultTransport({
|
|
11
54
|
endpoint,
|
|
12
55
|
body,
|
|
@@ -33,14 +76,32 @@ function toPositiveInteger(value, fallback) {
|
|
|
33
76
|
const rounded = Math.floor(value);
|
|
34
77
|
return rounded > 0 ? rounded : fallback;
|
|
35
78
|
}
|
|
79
|
+
function resolveSessionId(configSessionId, previousSessionId) {
|
|
80
|
+
const explicitSessionId = configSessionId?.trim();
|
|
81
|
+
if (explicitSessionId) {
|
|
82
|
+
return explicitSessionId;
|
|
83
|
+
}
|
|
84
|
+
if (previousSessionId) {
|
|
85
|
+
return previousSessionId;
|
|
86
|
+
}
|
|
87
|
+
return createId("session");
|
|
88
|
+
}
|
|
36
89
|
function resolveConfig(config, previous) {
|
|
37
90
|
const source = (config.source ?? previous?.source ?? "").trim();
|
|
38
91
|
if (!source) {
|
|
39
92
|
throw new Error("Local space analytics requires a non-empty source.");
|
|
40
93
|
}
|
|
94
|
+
const runtime = resolveRuntime(config.runtime, previous?.runtime);
|
|
95
|
+
const channel = resolveChannel(config.channel, runtime, previous?.channel);
|
|
96
|
+
const endpointCandidate = config.endpoint !== void 0 ? config.endpoint : previous?.endpoint;
|
|
97
|
+
const endpoint = endpointCandidate?.trim() || void 0;
|
|
41
98
|
return {
|
|
42
99
|
source,
|
|
43
|
-
endpoint
|
|
100
|
+
endpoint,
|
|
101
|
+
channel,
|
|
102
|
+
runtime,
|
|
103
|
+
sessionId: resolveSessionId(config.sessionId, previous?.sessionId),
|
|
104
|
+
injectChannelContext: config.injectChannelContext ?? previous?.injectChannelContext ?? true,
|
|
44
105
|
enabled: config.enabled ?? previous?.enabled ?? true,
|
|
45
106
|
defaultContext: {
|
|
46
107
|
...previous?.defaultContext ?? {},
|
|
@@ -60,15 +121,30 @@ function resolveConfig(config, previous) {
|
|
|
60
121
|
config.maxQueueSize ?? previous?.maxQueueSize,
|
|
61
122
|
DEFAULT_MAX_QUEUE_SIZE
|
|
62
123
|
),
|
|
63
|
-
storageKey: (config.storageKey
|
|
124
|
+
storageKey: resolveStorageKey(config.storageKey, source, channel, previous),
|
|
64
125
|
transport: config.transport ?? previous?.transport ?? defaultTransport,
|
|
65
126
|
onError: config.onError ?? previous?.onError
|
|
66
127
|
};
|
|
67
128
|
}
|
|
68
|
-
function
|
|
69
|
-
|
|
129
|
+
function isStoredRecordCandidate(value) {
|
|
130
|
+
if (!value || typeof value !== "object") {
|
|
131
|
+
return false;
|
|
132
|
+
}
|
|
133
|
+
const candidate = value;
|
|
134
|
+
return typeof candidate.id === "string" && typeof candidate.component === "string" && typeof candidate.action === "string" && typeof candidate.source === "string" && typeof candidate.sessionId === "string" && typeof candidate.timestamp === "number";
|
|
135
|
+
}
|
|
136
|
+
function normalizeStoredRecord(value, fallbackConfig) {
|
|
137
|
+
const context = value.context && typeof value.context === "object" && !Array.isArray(value.context) ? value.context : {};
|
|
138
|
+
const channel = value.channel === "frontend" || value.channel === "backend" ? value.channel : fallbackConfig.channel;
|
|
139
|
+
const runtime = value.runtime === "browser" || value.runtime === "server" ? value.runtime : fallbackConfig.runtime;
|
|
140
|
+
return {
|
|
141
|
+
...value,
|
|
142
|
+
channel,
|
|
143
|
+
runtime,
|
|
144
|
+
context
|
|
145
|
+
};
|
|
70
146
|
}
|
|
71
|
-
function readQueue(storageKey) {
|
|
147
|
+
function readQueue(storageKey, fallbackConfig) {
|
|
72
148
|
if (!isBrowserEnvironment() || typeof window.localStorage === "undefined") {
|
|
73
149
|
return [];
|
|
74
150
|
}
|
|
@@ -81,18 +157,11 @@ function readQueue(storageKey) {
|
|
|
81
157
|
if (!Array.isArray(parsed)) {
|
|
82
158
|
return [];
|
|
83
159
|
}
|
|
84
|
-
return parsed.filter(isStoredRecordCandidate);
|
|
160
|
+
return parsed.filter(isStoredRecordCandidate).map((record) => normalizeStoredRecord(record, fallbackConfig));
|
|
85
161
|
} catch {
|
|
86
162
|
return [];
|
|
87
163
|
}
|
|
88
164
|
}
|
|
89
|
-
function isStoredRecordCandidate(value) {
|
|
90
|
-
if (!value || typeof value !== "object") {
|
|
91
|
-
return false;
|
|
92
|
-
}
|
|
93
|
-
const candidate = value;
|
|
94
|
-
return typeof candidate.id === "string" && typeof candidate.component === "string" && typeof candidate.action === "string" && typeof candidate.source === "string" && typeof candidate.sessionId === "string" && typeof candidate.timestamp === "number";
|
|
95
|
-
}
|
|
96
165
|
function writeQueue(storageKey, queue) {
|
|
97
166
|
if (!isBrowserEnvironment() || typeof window.localStorage === "undefined") {
|
|
98
167
|
return;
|
|
@@ -106,17 +175,35 @@ function writeQueue(storageKey, queue) {
|
|
|
106
175
|
} catch {
|
|
107
176
|
}
|
|
108
177
|
}
|
|
109
|
-
function createPayload(
|
|
178
|
+
function createPayload(config, events) {
|
|
110
179
|
return JSON.stringify({
|
|
111
|
-
source,
|
|
180
|
+
source: config.source,
|
|
181
|
+
channel: config.channel,
|
|
182
|
+
runtime: config.runtime,
|
|
112
183
|
sentAt: Date.now(),
|
|
113
184
|
events
|
|
114
185
|
});
|
|
115
186
|
}
|
|
187
|
+
function createMergedContext(config, eventChannel, eventContext) {
|
|
188
|
+
const mergedContext = {
|
|
189
|
+
...config.defaultContext,
|
|
190
|
+
...eventContext ?? {}
|
|
191
|
+
};
|
|
192
|
+
if (config.injectChannelContext) {
|
|
193
|
+
if (mergedContext.analyticsChannel === void 0) {
|
|
194
|
+
mergedContext.analyticsChannel = eventChannel;
|
|
195
|
+
}
|
|
196
|
+
if (mergedContext.analyticsRuntime === void 0) {
|
|
197
|
+
mergedContext.analyticsRuntime = config.runtime;
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
return mergedContext;
|
|
201
|
+
}
|
|
116
202
|
function createLocalSpaceAnalyticsClient(config) {
|
|
117
203
|
let resolvedConfig = resolveConfig(config);
|
|
118
|
-
|
|
119
|
-
|
|
204
|
+
let queue = readQueue(resolvedConfig.storageKey, resolvedConfig).slice(
|
|
205
|
+
-resolvedConfig.maxQueueSize
|
|
206
|
+
);
|
|
120
207
|
let flushTimer = null;
|
|
121
208
|
let isFlushing = false;
|
|
122
209
|
let flushQueuedAfterCurrent = false;
|
|
@@ -137,7 +224,7 @@ function createLocalSpaceAnalyticsClient(config) {
|
|
|
137
224
|
}
|
|
138
225
|
const events = queue.slice(0, resolvedConfig.batchSize);
|
|
139
226
|
try {
|
|
140
|
-
const body = createPayload(resolvedConfig
|
|
227
|
+
const body = createPayload(resolvedConfig, events);
|
|
141
228
|
const blob = new Blob([body], { type: JSON_CONTENT_TYPE_HEADER });
|
|
142
229
|
const sent = navigator.sendBeacon(resolvedConfig.endpoint, blob);
|
|
143
230
|
if (sent) {
|
|
@@ -161,7 +248,7 @@ function createLocalSpaceAnalyticsClient(config) {
|
|
|
161
248
|
return;
|
|
162
249
|
}
|
|
163
250
|
const events = queue.slice(0, resolvedConfig.batchSize);
|
|
164
|
-
const body = createPayload(resolvedConfig
|
|
251
|
+
const body = createPayload(resolvedConfig, events);
|
|
165
252
|
isFlushing = true;
|
|
166
253
|
try {
|
|
167
254
|
await resolvedConfig.transport({
|
|
@@ -217,35 +304,54 @@ function createLocalSpaceAnalyticsClient(config) {
|
|
|
217
304
|
window.addEventListener("pagehide", handlePageHide);
|
|
218
305
|
}
|
|
219
306
|
startFlushTimer();
|
|
307
|
+
const trackWithChannel = (event, channel) => {
|
|
308
|
+
const trackableEvent = {
|
|
309
|
+
...event,
|
|
310
|
+
channel
|
|
311
|
+
};
|
|
312
|
+
track(trackableEvent);
|
|
313
|
+
};
|
|
314
|
+
const track = (event) => {
|
|
315
|
+
if (isDestroyed || !resolvedConfig.enabled) {
|
|
316
|
+
return;
|
|
317
|
+
}
|
|
318
|
+
const eventChannel = event.channel ?? resolvedConfig.channel;
|
|
319
|
+
const requestId = typeof event.requestId === "string" && event.requestId.trim() ? event.requestId.trim() : void 0;
|
|
320
|
+
const record = {
|
|
321
|
+
id: createId("event"),
|
|
322
|
+
component: event.component,
|
|
323
|
+
action: event.action,
|
|
324
|
+
channel: eventChannel,
|
|
325
|
+
runtime: resolvedConfig.runtime,
|
|
326
|
+
label: event.label,
|
|
327
|
+
href: event.href,
|
|
328
|
+
variant: event.variant,
|
|
329
|
+
requestId,
|
|
330
|
+
source: resolvedConfig.source,
|
|
331
|
+
sessionId: resolvedConfig.sessionId,
|
|
332
|
+
timestamp: event.timestamp ?? Date.now(),
|
|
333
|
+
context: createMergedContext(resolvedConfig, eventChannel, event.context)
|
|
334
|
+
};
|
|
335
|
+
queue.push(record);
|
|
336
|
+
trimQueue();
|
|
337
|
+
persistQueue();
|
|
338
|
+
if (queue.length >= resolvedConfig.batchSize) {
|
|
339
|
+
void flush();
|
|
340
|
+
}
|
|
341
|
+
};
|
|
220
342
|
return {
|
|
221
343
|
get source() {
|
|
222
344
|
return resolvedConfig.source;
|
|
223
345
|
},
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
href: event.href,
|
|
234
|
-
variant: event.variant,
|
|
235
|
-
source: resolvedConfig.source,
|
|
236
|
-
sessionId,
|
|
237
|
-
timestamp: event.timestamp ?? Date.now(),
|
|
238
|
-
context: {
|
|
239
|
-
...resolvedConfig.defaultContext,
|
|
240
|
-
...event.context ?? {}
|
|
241
|
-
}
|
|
242
|
-
};
|
|
243
|
-
queue.push(record);
|
|
244
|
-
trimQueue();
|
|
245
|
-
persistQueue();
|
|
246
|
-
if (queue.length >= resolvedConfig.batchSize) {
|
|
247
|
-
void flush();
|
|
248
|
-
}
|
|
346
|
+
get channel() {
|
|
347
|
+
return resolvedConfig.channel;
|
|
348
|
+
},
|
|
349
|
+
track,
|
|
350
|
+
trackFrontend(event) {
|
|
351
|
+
trackWithChannel(event, "frontend");
|
|
352
|
+
},
|
|
353
|
+
trackBackend(event) {
|
|
354
|
+
trackWithChannel(event, "backend");
|
|
249
355
|
},
|
|
250
356
|
flush,
|
|
251
357
|
updateConfig(nextConfig) {
|
|
@@ -290,9 +396,28 @@ function createLocalSpaceAnalyticsClient(config) {
|
|
|
290
396
|
}
|
|
291
397
|
};
|
|
292
398
|
}
|
|
293
|
-
function
|
|
399
|
+
function createFrontendAnalyticsClient(config) {
|
|
400
|
+
return createLocalSpaceAnalyticsClient({
|
|
401
|
+
...config,
|
|
402
|
+
channel: "frontend",
|
|
403
|
+
runtime: config.runtime ?? "browser"
|
|
404
|
+
});
|
|
405
|
+
}
|
|
406
|
+
function createBackendAnalyticsClient(config) {
|
|
407
|
+
return createLocalSpaceAnalyticsClient({
|
|
408
|
+
...config,
|
|
409
|
+
channel: "backend",
|
|
410
|
+
runtime: config.runtime ?? "server"
|
|
411
|
+
});
|
|
412
|
+
}
|
|
413
|
+
function createNoopLocalSpaceAnalyticsClient(source = "noop", channel = "frontend") {
|
|
414
|
+
const runtime = isBrowserEnvironment() ? "browser" : "server";
|
|
294
415
|
const noopConfig = {
|
|
295
416
|
source,
|
|
417
|
+
channel,
|
|
418
|
+
runtime,
|
|
419
|
+
sessionId: createId("session"),
|
|
420
|
+
injectChannelContext: true,
|
|
296
421
|
enabled: false,
|
|
297
422
|
endpoint: void 0,
|
|
298
423
|
defaultContext: {},
|
|
@@ -300,13 +425,16 @@ function createNoopLocalSpaceAnalyticsClient(source = "noop") {
|
|
|
300
425
|
flushIntervalMs: DEFAULT_FLUSH_INTERVAL_MS,
|
|
301
426
|
batchSize: DEFAULT_BATCH_SIZE,
|
|
302
427
|
maxQueueSize: DEFAULT_MAX_QUEUE_SIZE,
|
|
303
|
-
storageKey:
|
|
428
|
+
storageKey: buildDefaultStorageKey(source, channel),
|
|
304
429
|
transport: async () => void 0,
|
|
305
430
|
onError: void 0
|
|
306
431
|
};
|
|
307
432
|
return {
|
|
308
433
|
source,
|
|
434
|
+
channel,
|
|
309
435
|
track: () => void 0,
|
|
436
|
+
trackFrontend: () => void 0,
|
|
437
|
+
trackBackend: () => void 0,
|
|
310
438
|
flush: async () => void 0,
|
|
311
439
|
updateConfig: () => void 0,
|
|
312
440
|
getConfig: () => noopConfig,
|
|
@@ -322,6 +450,10 @@ function AnalyticsProvider({
|
|
|
322
450
|
children,
|
|
323
451
|
source = "react-app",
|
|
324
452
|
endpoint,
|
|
453
|
+
channel,
|
|
454
|
+
runtime,
|
|
455
|
+
sessionId,
|
|
456
|
+
injectChannelContext,
|
|
325
457
|
enabled = true,
|
|
326
458
|
defaultContext,
|
|
327
459
|
headers,
|
|
@@ -343,6 +475,10 @@ function AnalyticsProvider({
|
|
|
343
475
|
return createLocalSpaceAnalyticsClient({
|
|
344
476
|
source,
|
|
345
477
|
endpoint,
|
|
478
|
+
channel,
|
|
479
|
+
runtime,
|
|
480
|
+
sessionId,
|
|
481
|
+
injectChannelContext,
|
|
346
482
|
enabled,
|
|
347
483
|
defaultContext,
|
|
348
484
|
headers,
|
|
@@ -357,6 +493,10 @@ function AnalyticsProvider({
|
|
|
357
493
|
client,
|
|
358
494
|
source,
|
|
359
495
|
endpoint,
|
|
496
|
+
channel,
|
|
497
|
+
runtime,
|
|
498
|
+
sessionId,
|
|
499
|
+
injectChannelContext,
|
|
360
500
|
enabled,
|
|
361
501
|
defaultContext,
|
|
362
502
|
headers,
|
|
@@ -403,9 +543,11 @@ function useComponentInteractionTracker(component, baseContext = {}) {
|
|
|
403
543
|
trackInteraction({
|
|
404
544
|
component,
|
|
405
545
|
action,
|
|
546
|
+
channel: details?.channel,
|
|
406
547
|
label: details?.label,
|
|
407
548
|
href: details?.href,
|
|
408
549
|
variant: details?.variant,
|
|
550
|
+
requestId: details?.requestId,
|
|
409
551
|
timestamp: details?.timestamp,
|
|
410
552
|
context: {
|
|
411
553
|
...baseContext,
|
|
@@ -418,6 +560,8 @@ function useComponentInteractionTracker(component, baseContext = {}) {
|
|
|
418
560
|
}
|
|
419
561
|
export {
|
|
420
562
|
AnalyticsProvider,
|
|
563
|
+
createBackendAnalyticsClient,
|
|
564
|
+
createFrontendAnalyticsClient,
|
|
421
565
|
createLocalSpaceAnalyticsClient,
|
|
422
566
|
createNoopLocalSpaceAnalyticsClient,
|
|
423
567
|
useAnalytics,
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/core/client.ts","../src/react/provider.tsx","../src/react/hooks.ts"],"sourcesContent":["import type {\n AnalyticsTransport,\n LocalSpaceAnalyticsClient,\n LocalSpaceAnalyticsConfig,\n LocalSpaceAnalyticsEvent,\n LocalSpaceAnalyticsRecord,\n ResolvedLocalSpaceAnalyticsConfig,\n} from \"./types.js\";\n\nconst DEFAULT_FLUSH_INTERVAL_MS = 5000;\nconst DEFAULT_BATCH_SIZE = 20;\nconst DEFAULT_MAX_QUEUE_SIZE = 500;\nconst DEFAULT_STORAGE_KEY = \"plasius.analytics.local-space.queue\";\n\nconst JSON_CONTENT_TYPE_HEADER = \"application/json\";\n\nfunction createId(prefix: string): string {\n return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nasync function defaultTransport({\n endpoint,\n body,\n headers,\n keepalive,\n}: {\n endpoint: string;\n body: string;\n headers: Record<string, string>;\n keepalive: boolean;\n}): Promise<void> {\n if (typeof fetch !== \"function\") {\n return;\n }\n\n const response = await fetch(endpoint, {\n method: \"POST\",\n headers,\n body,\n keepalive,\n });\n\n if (!response.ok) {\n throw new Error(`Analytics transport failed with status ${response.status}.`);\n }\n}\n\nfunction toPositiveInteger(value: number | undefined, fallback: number): number {\n if (typeof value !== \"number\" || !Number.isFinite(value)) {\n return fallback;\n }\n\n const rounded = Math.floor(value);\n return rounded > 0 ? rounded : fallback;\n}\n\nfunction resolveConfig(\n config: LocalSpaceAnalyticsConfig,\n previous?: ResolvedLocalSpaceAnalyticsConfig\n): ResolvedLocalSpaceAnalyticsConfig {\n const source = (config.source ?? previous?.source ?? \"\").trim();\n\n if (!source) {\n throw new Error(\"Local space analytics requires a non-empty source.\");\n }\n\n return {\n source,\n endpoint: config.endpoint?.trim(),\n enabled: config.enabled ?? previous?.enabled ?? true,\n defaultContext: {\n ...(previous?.defaultContext ?? {}),\n ...(config.defaultContext ?? {}),\n },\n headers: {\n \"content-type\": JSON_CONTENT_TYPE_HEADER,\n ...(previous?.headers ?? {}),\n ...(config.headers ?? {}),\n },\n flushIntervalMs: toPositiveInteger(\n config.flushIntervalMs ?? previous?.flushIntervalMs,\n DEFAULT_FLUSH_INTERVAL_MS\n ),\n batchSize: toPositiveInteger(config.batchSize ?? previous?.batchSize, DEFAULT_BATCH_SIZE),\n maxQueueSize: toPositiveInteger(\n config.maxQueueSize ?? previous?.maxQueueSize,\n DEFAULT_MAX_QUEUE_SIZE\n ),\n storageKey: (config.storageKey ?? previous?.storageKey ?? DEFAULT_STORAGE_KEY).trim(),\n transport: (config.transport ?? previous?.transport ?? defaultTransport) as AnalyticsTransport,\n onError: config.onError ?? previous?.onError,\n };\n}\n\nfunction isBrowserEnvironment(): boolean {\n return typeof window !== \"undefined\" && typeof document !== \"undefined\";\n}\n\nfunction readQueue(storageKey: string): LocalSpaceAnalyticsRecord[] {\n if (!isBrowserEnvironment() || typeof window.localStorage === \"undefined\") {\n return [];\n }\n\n try {\n const rawValue = window.localStorage.getItem(storageKey);\n if (!rawValue) {\n return [];\n }\n\n const parsed = JSON.parse(rawValue);\n if (!Array.isArray(parsed)) {\n return [];\n }\n\n return parsed.filter(isStoredRecordCandidate);\n } catch {\n return [];\n }\n}\n\nfunction isStoredRecordCandidate(value: unknown): value is LocalSpaceAnalyticsRecord {\n if (!value || typeof value !== \"object\") {\n return false;\n }\n\n const candidate = value as Partial<LocalSpaceAnalyticsRecord>;\n return (\n typeof candidate.id === \"string\" &&\n typeof candidate.component === \"string\" &&\n typeof candidate.action === \"string\" &&\n typeof candidate.source === \"string\" &&\n typeof candidate.sessionId === \"string\" &&\n typeof candidate.timestamp === \"number\"\n );\n}\n\nfunction writeQueue(storageKey: string, queue: LocalSpaceAnalyticsRecord[]): void {\n if (!isBrowserEnvironment() || typeof window.localStorage === \"undefined\") {\n return;\n }\n\n try {\n if (queue.length === 0) {\n window.localStorage.removeItem(storageKey);\n return;\n }\n\n window.localStorage.setItem(storageKey, JSON.stringify(queue));\n } catch {\n // Ignored by design: storage quota errors should never break host app UX.\n }\n}\n\nfunction createPayload(source: string, events: LocalSpaceAnalyticsRecord[]): string {\n return JSON.stringify({\n source,\n sentAt: Date.now(),\n events,\n });\n}\n\nexport function createLocalSpaceAnalyticsClient(\n config: LocalSpaceAnalyticsConfig\n): LocalSpaceAnalyticsClient {\n let resolvedConfig = resolveConfig(config);\n const sessionId = createId(\"session\");\n let queue = readQueue(resolvedConfig.storageKey).slice(-resolvedConfig.maxQueueSize);\n\n let flushTimer: ReturnType<typeof setInterval> | null = null;\n let isFlushing = false;\n let flushQueuedAfterCurrent = false;\n let isDestroyed = false;\n\n const persistQueue = () => writeQueue(resolvedConfig.storageKey, queue);\n\n const trimQueue = () => {\n if (queue.length <= resolvedConfig.maxQueueSize) {\n return;\n }\n\n queue = queue.slice(queue.length - resolvedConfig.maxQueueSize);\n };\n\n const flushWithBeacon = (): boolean => {\n if (!resolvedConfig.endpoint || queue.length === 0) {\n return false;\n }\n\n if (\n typeof navigator === \"undefined\" ||\n typeof navigator.sendBeacon !== \"function\"\n ) {\n return false;\n }\n\n const events = queue.slice(0, resolvedConfig.batchSize);\n\n try {\n const body = createPayload(resolvedConfig.source, events);\n const blob = new Blob([body], { type: JSON_CONTENT_TYPE_HEADER });\n const sent = navigator.sendBeacon(resolvedConfig.endpoint, blob);\n\n if (sent) {\n queue = queue.slice(events.length);\n persistQueue();\n }\n\n return sent;\n } catch {\n return false;\n }\n };\n\n const flush = async (): Promise<void> => {\n if (isDestroyed || !resolvedConfig.enabled || !resolvedConfig.endpoint) {\n return;\n }\n\n if (queue.length === 0) {\n return;\n }\n\n if (isFlushing) {\n flushQueuedAfterCurrent = true;\n return;\n }\n\n const events = queue.slice(0, resolvedConfig.batchSize);\n const body = createPayload(resolvedConfig.source, events);\n\n isFlushing = true;\n\n try {\n await resolvedConfig.transport({\n endpoint: resolvedConfig.endpoint,\n body,\n headers: resolvedConfig.headers,\n keepalive: true,\n });\n\n queue = queue.slice(events.length);\n persistQueue();\n } catch (error) {\n resolvedConfig.onError?.(error);\n } finally {\n isFlushing = false;\n\n if (flushQueuedAfterCurrent) {\n flushQueuedAfterCurrent = false;\n if (queue.length > 0) {\n void flush();\n }\n }\n }\n };\n\n const startFlushTimer = () => {\n if (flushTimer) {\n clearInterval(flushTimer);\n flushTimer = null;\n }\n\n if (!resolvedConfig.enabled) {\n return;\n }\n\n flushTimer = setInterval(() => {\n void flush();\n }, resolvedConfig.flushIntervalMs);\n };\n\n const handleVisibilityChange = () => {\n if (typeof document === \"undefined\") {\n return;\n }\n\n if (document.visibilityState !== \"hidden\") {\n return;\n }\n\n if (!flushWithBeacon()) {\n void flush();\n }\n };\n\n const handlePageHide = () => {\n if (!flushWithBeacon()) {\n void flush();\n }\n };\n\n if (isBrowserEnvironment()) {\n document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n window.addEventListener(\"pagehide\", handlePageHide);\n }\n\n startFlushTimer();\n\n return {\n get source() {\n return resolvedConfig.source;\n },\n\n track(event: LocalSpaceAnalyticsEvent) {\n if (isDestroyed || !resolvedConfig.enabled) {\n return;\n }\n\n const record: LocalSpaceAnalyticsRecord = {\n id: createId(\"event\"),\n component: event.component,\n action: event.action,\n label: event.label,\n href: event.href,\n variant: event.variant,\n source: resolvedConfig.source,\n sessionId,\n timestamp: event.timestamp ?? Date.now(),\n context: {\n ...resolvedConfig.defaultContext,\n ...(event.context ?? {}),\n },\n };\n\n queue.push(record);\n trimQueue();\n persistQueue();\n\n if (queue.length >= resolvedConfig.batchSize) {\n void flush();\n }\n },\n\n flush,\n\n updateConfig(nextConfig: Partial<LocalSpaceAnalyticsConfig>) {\n if (isDestroyed) {\n return;\n }\n\n const previousStorageKey = resolvedConfig.storageKey;\n resolvedConfig = resolveConfig(\n {\n ...resolvedConfig,\n ...nextConfig,\n source: nextConfig.source ?? resolvedConfig.source,\n },\n resolvedConfig\n );\n\n if (previousStorageKey !== resolvedConfig.storageKey) {\n writeQueue(previousStorageKey, []);\n persistQueue();\n }\n\n startFlushTimer();\n\n if (resolvedConfig.endpoint && queue.length > 0) {\n void flush();\n }\n },\n\n getConfig() {\n return resolvedConfig;\n },\n\n destroy() {\n if (isDestroyed) {\n return;\n }\n\n isDestroyed = true;\n\n if (flushTimer) {\n clearInterval(flushTimer);\n flushTimer = null;\n }\n\n if (isBrowserEnvironment()) {\n document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n window.removeEventListener(\"pagehide\", handlePageHide);\n }\n\n void flush();\n },\n };\n}\n\nexport function createNoopLocalSpaceAnalyticsClient(\n source = \"noop\"\n): LocalSpaceAnalyticsClient {\n const noopConfig: ResolvedLocalSpaceAnalyticsConfig = {\n source,\n enabled: false,\n endpoint: undefined,\n defaultContext: {},\n headers: { \"content-type\": JSON_CONTENT_TYPE_HEADER },\n flushIntervalMs: DEFAULT_FLUSH_INTERVAL_MS,\n batchSize: DEFAULT_BATCH_SIZE,\n maxQueueSize: DEFAULT_MAX_QUEUE_SIZE,\n storageKey: DEFAULT_STORAGE_KEY,\n transport: async () => undefined,\n onError: undefined,\n };\n\n return {\n source,\n track: () => undefined,\n flush: async () => undefined,\n updateConfig: () => undefined,\n getConfig: () => noopConfig,\n destroy: () => undefined,\n };\n}\n","import { createContext, useContext, useEffect, useMemo, type ReactNode } from \"react\";\nimport {\n createLocalSpaceAnalyticsClient,\n createNoopLocalSpaceAnalyticsClient,\n} from \"../core/client.js\";\nimport type {\n LocalSpaceAnalyticsClient,\n LocalSpaceAnalyticsConfig,\n LocalSpaceAnalyticsEvent,\n} from \"../core/types.js\";\n\nexport interface AnalyticsProviderProps {\n children: ReactNode;\n source?: string;\n endpoint?: string;\n enabled?: boolean;\n defaultContext?: LocalSpaceAnalyticsConfig[\"defaultContext\"];\n headers?: LocalSpaceAnalyticsConfig[\"headers\"];\n flushIntervalMs?: number;\n batchSize?: number;\n maxQueueSize?: number;\n storageKey?: string;\n transport?: LocalSpaceAnalyticsConfig[\"transport\"];\n onError?: LocalSpaceAnalyticsConfig[\"onError\"];\n client?: LocalSpaceAnalyticsClient;\n}\n\nexport interface AnalyticsContextValue {\n client: LocalSpaceAnalyticsClient;\n trackInteraction: (event: LocalSpaceAnalyticsEvent) => void;\n flush: () => Promise<void>;\n}\n\nconst AnalyticsContext = createContext<AnalyticsContextValue | null>(null);\n\nexport function AnalyticsProvider({\n children,\n source = \"react-app\",\n endpoint,\n enabled = true,\n defaultContext,\n headers,\n flushIntervalMs,\n batchSize,\n maxQueueSize,\n storageKey,\n transport,\n onError,\n client,\n}: AnalyticsProviderProps) {\n const managedClient = useMemo(() => {\n if (client) {\n return client;\n }\n\n if (!enabled) {\n return createNoopLocalSpaceAnalyticsClient(source);\n }\n\n return createLocalSpaceAnalyticsClient({\n source,\n endpoint,\n enabled,\n defaultContext,\n headers,\n flushIntervalMs,\n batchSize,\n maxQueueSize,\n storageKey,\n transport,\n onError,\n });\n }, [\n client,\n source,\n endpoint,\n enabled,\n defaultContext,\n headers,\n flushIntervalMs,\n batchSize,\n maxQueueSize,\n storageKey,\n transport,\n onError,\n ]);\n\n useEffect(() => {\n return () => {\n if (!client) {\n managedClient.destroy();\n }\n };\n }, [client, managedClient]);\n\n const value = useMemo<AnalyticsContextValue>(\n () => ({\n client: managedClient,\n trackInteraction: (event: LocalSpaceAnalyticsEvent) => {\n managedClient.track(event);\n },\n flush: () => managedClient.flush(),\n }),\n [managedClient]\n );\n\n return <AnalyticsContext.Provider value={value}>{children}</AnalyticsContext.Provider>;\n}\n\nexport function useAnalytics(): AnalyticsContextValue {\n const context = useContext(AnalyticsContext);\n\n if (!context) {\n throw new Error(\"useAnalytics must be used within AnalyticsProvider.\");\n }\n\n return context;\n}\n","import { useCallback } from \"react\";\nimport type { AnalyticsContext, LocalSpaceAnalyticsEvent } from \"../core/types.js\";\nimport { useAnalytics } from \"./provider.js\";\n\nexport interface TrackInteractionDetails\n extends Omit<LocalSpaceAnalyticsEvent, \"component\" | \"action\" | \"context\"> {\n context?: AnalyticsContext;\n}\n\nexport function useComponentInteractionTracker(\n component: string,\n baseContext: AnalyticsContext = {}\n): (action: string, details?: TrackInteractionDetails) => void {\n const { trackInteraction } = useAnalytics();\n\n return useCallback(\n (action: string, details?: TrackInteractionDetails) => {\n trackInteraction({\n component,\n action,\n label: details?.label,\n href: details?.href,\n variant: details?.variant,\n timestamp: details?.timestamp,\n context: {\n ...baseContext,\n ...(details?.context ?? {}),\n },\n });\n },\n [baseContext, component, trackInteraction]\n );\n}\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../src/core/client.ts","../src/react/provider.tsx","../src/react/hooks.ts"],"sourcesContent":["import type {\n AnalyticsChannel,\n AnalyticsContext,\n AnalyticsRuntime,\n AnalyticsTransport,\n LocalSpaceAnalyticsClient,\n LocalSpaceAnalyticsConfig,\n LocalSpaceAnalyticsEvent,\n LocalSpaceAnalyticsRecord,\n ResolvedLocalSpaceAnalyticsConfig,\n} from \"./types.js\";\n\nconst DEFAULT_FLUSH_INTERVAL_MS = 5000;\nconst DEFAULT_BATCH_SIZE = 20;\nconst DEFAULT_MAX_QUEUE_SIZE = 500;\nconst DEFAULT_STORAGE_KEY_PREFIX = \"plasius.analytics.local-space.queue\";\n\nconst JSON_CONTENT_TYPE_HEADER = \"application/json\";\n\nfunction createId(prefix: string): string {\n return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction isBrowserEnvironment(): boolean {\n return typeof window !== \"undefined\" && typeof document !== \"undefined\";\n}\n\nfunction resolveRuntime(\n explicitRuntime: AnalyticsRuntime | undefined,\n previousRuntime: AnalyticsRuntime | undefined\n): AnalyticsRuntime {\n if (explicitRuntime) {\n return explicitRuntime;\n }\n\n if (previousRuntime) {\n return previousRuntime;\n }\n\n return isBrowserEnvironment() ? \"browser\" : \"server\";\n}\n\nfunction resolveChannel(\n explicitChannel: AnalyticsChannel | undefined,\n runtime: AnalyticsRuntime,\n previousChannel: AnalyticsChannel | undefined\n): AnalyticsChannel {\n if (explicitChannel) {\n return explicitChannel;\n }\n\n if (previousChannel) {\n return previousChannel;\n }\n\n return runtime === \"server\" ? \"backend\" : \"frontend\";\n}\n\nfunction sanitizeStorageSourceSegment(source: string): string {\n const normalized = source.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, \"-\");\n return normalized || \"unknown-source\";\n}\n\nfunction buildDefaultStorageKey(source: string, channel: AnalyticsChannel): string {\n return `${DEFAULT_STORAGE_KEY_PREFIX}.${channel}.${sanitizeStorageSourceSegment(source)}`;\n}\n\nfunction resolveStorageKey(\n configStorageKey: string | undefined,\n source: string,\n channel: AnalyticsChannel,\n previous?: ResolvedLocalSpaceAnalyticsConfig\n): string {\n const explicitStorageKey = configStorageKey?.trim();\n if (explicitStorageKey) {\n return explicitStorageKey;\n }\n\n const defaultStorageKey = buildDefaultStorageKey(source, channel);\n if (!previous) {\n return defaultStorageKey;\n }\n\n const previousDefaultStorageKey = buildDefaultStorageKey(\n previous.source,\n previous.channel\n );\n\n return previous.storageKey === previousDefaultStorageKey\n ? defaultStorageKey\n : previous.storageKey;\n}\n\nasync function defaultTransport({\n endpoint,\n body,\n headers,\n keepalive,\n}: {\n endpoint: string;\n body: string;\n headers: Record<string, string>;\n keepalive: boolean;\n}): Promise<void> {\n if (typeof fetch !== \"function\") {\n return;\n }\n\n const response = await fetch(endpoint, {\n method: \"POST\",\n headers,\n body,\n keepalive,\n });\n\n if (!response.ok) {\n throw new Error(`Analytics transport failed with status ${response.status}.`);\n }\n}\n\nfunction toPositiveInteger(value: number | undefined, fallback: number): number {\n if (typeof value !== \"number\" || !Number.isFinite(value)) {\n return fallback;\n }\n\n const rounded = Math.floor(value);\n return rounded > 0 ? rounded : fallback;\n}\n\nfunction resolveSessionId(\n configSessionId: string | undefined,\n previousSessionId: string | undefined\n): string {\n const explicitSessionId = configSessionId?.trim();\n if (explicitSessionId) {\n return explicitSessionId;\n }\n\n if (previousSessionId) {\n return previousSessionId;\n }\n\n return createId(\"session\");\n}\n\nfunction resolveConfig(\n config: LocalSpaceAnalyticsConfig,\n previous?: ResolvedLocalSpaceAnalyticsConfig\n): ResolvedLocalSpaceAnalyticsConfig {\n const source = (config.source ?? previous?.source ?? \"\").trim();\n if (!source) {\n throw new Error(\"Local space analytics requires a non-empty source.\");\n }\n\n const runtime = resolveRuntime(config.runtime, previous?.runtime);\n const channel = resolveChannel(config.channel, runtime, previous?.channel);\n\n const endpointCandidate =\n config.endpoint !== undefined ? config.endpoint : previous?.endpoint;\n const endpoint = endpointCandidate?.trim() || undefined;\n\n return {\n source,\n endpoint,\n channel,\n runtime,\n sessionId: resolveSessionId(config.sessionId, previous?.sessionId),\n injectChannelContext:\n config.injectChannelContext ?? previous?.injectChannelContext ?? true,\n enabled: config.enabled ?? previous?.enabled ?? true,\n defaultContext: {\n ...(previous?.defaultContext ?? {}),\n ...(config.defaultContext ?? {}),\n },\n headers: {\n \"content-type\": JSON_CONTENT_TYPE_HEADER,\n ...(previous?.headers ?? {}),\n ...(config.headers ?? {}),\n },\n flushIntervalMs: toPositiveInteger(\n config.flushIntervalMs ?? previous?.flushIntervalMs,\n DEFAULT_FLUSH_INTERVAL_MS\n ),\n batchSize: toPositiveInteger(config.batchSize ?? previous?.batchSize, DEFAULT_BATCH_SIZE),\n maxQueueSize: toPositiveInteger(\n config.maxQueueSize ?? previous?.maxQueueSize,\n DEFAULT_MAX_QUEUE_SIZE\n ),\n storageKey: resolveStorageKey(config.storageKey, source, channel, previous),\n transport: (config.transport ?? previous?.transport ?? defaultTransport) as AnalyticsTransport,\n onError: config.onError ?? previous?.onError,\n };\n}\n\nfunction isStoredRecordCandidate(value: unknown): value is LocalSpaceAnalyticsRecord {\n if (!value || typeof value !== \"object\") {\n return false;\n }\n\n const candidate = value as Partial<LocalSpaceAnalyticsRecord>;\n return (\n typeof candidate.id === \"string\" &&\n typeof candidate.component === \"string\" &&\n typeof candidate.action === \"string\" &&\n typeof candidate.source === \"string\" &&\n typeof candidate.sessionId === \"string\" &&\n typeof candidate.timestamp === \"number\"\n );\n}\n\nfunction normalizeStoredRecord(\n value: LocalSpaceAnalyticsRecord,\n fallbackConfig: ResolvedLocalSpaceAnalyticsConfig\n): LocalSpaceAnalyticsRecord {\n const context =\n value.context && typeof value.context === \"object\" && !Array.isArray(value.context)\n ? value.context\n : {};\n\n const channel: AnalyticsChannel =\n value.channel === \"frontend\" || value.channel === \"backend\"\n ? value.channel\n : fallbackConfig.channel;\n\n const runtime: AnalyticsRuntime =\n value.runtime === \"browser\" || value.runtime === \"server\"\n ? value.runtime\n : fallbackConfig.runtime;\n\n return {\n ...value,\n channel,\n runtime,\n context,\n };\n}\n\nfunction readQueue(\n storageKey: string,\n fallbackConfig: ResolvedLocalSpaceAnalyticsConfig\n): LocalSpaceAnalyticsRecord[] {\n if (!isBrowserEnvironment() || typeof window.localStorage === \"undefined\") {\n return [];\n }\n\n try {\n const rawValue = window.localStorage.getItem(storageKey);\n if (!rawValue) {\n return [];\n }\n\n const parsed = JSON.parse(rawValue);\n if (!Array.isArray(parsed)) {\n return [];\n }\n\n return parsed\n .filter(isStoredRecordCandidate)\n .map((record) => normalizeStoredRecord(record, fallbackConfig));\n } catch {\n return [];\n }\n}\n\nfunction writeQueue(storageKey: string, queue: LocalSpaceAnalyticsRecord[]): void {\n if (!isBrowserEnvironment() || typeof window.localStorage === \"undefined\") {\n return;\n }\n\n try {\n if (queue.length === 0) {\n window.localStorage.removeItem(storageKey);\n return;\n }\n\n window.localStorage.setItem(storageKey, JSON.stringify(queue));\n } catch {\n // Ignored by design: storage quota errors should never break host app UX.\n }\n}\n\nfunction createPayload(config: ResolvedLocalSpaceAnalyticsConfig, events: LocalSpaceAnalyticsRecord[]): string {\n return JSON.stringify({\n source: config.source,\n channel: config.channel,\n runtime: config.runtime,\n sentAt: Date.now(),\n events,\n });\n}\n\nfunction createMergedContext(\n config: ResolvedLocalSpaceAnalyticsConfig,\n eventChannel: AnalyticsChannel,\n eventContext: AnalyticsContext | undefined\n): AnalyticsContext {\n const mergedContext: AnalyticsContext = {\n ...config.defaultContext,\n ...(eventContext ?? {}),\n };\n\n if (config.injectChannelContext) {\n if (mergedContext.analyticsChannel === undefined) {\n mergedContext.analyticsChannel = eventChannel;\n }\n if (mergedContext.analyticsRuntime === undefined) {\n mergedContext.analyticsRuntime = config.runtime;\n }\n }\n\n return mergedContext;\n}\n\nexport function createLocalSpaceAnalyticsClient(\n config: LocalSpaceAnalyticsConfig\n): LocalSpaceAnalyticsClient {\n let resolvedConfig = resolveConfig(config);\n let queue = readQueue(resolvedConfig.storageKey, resolvedConfig).slice(\n -resolvedConfig.maxQueueSize\n );\n\n let flushTimer: ReturnType<typeof setInterval> | null = null;\n let isFlushing = false;\n let flushQueuedAfterCurrent = false;\n let isDestroyed = false;\n\n const persistQueue = () => writeQueue(resolvedConfig.storageKey, queue);\n\n const trimQueue = () => {\n if (queue.length <= resolvedConfig.maxQueueSize) {\n return;\n }\n\n queue = queue.slice(queue.length - resolvedConfig.maxQueueSize);\n };\n\n const flushWithBeacon = (): boolean => {\n if (!resolvedConfig.endpoint || queue.length === 0) {\n return false;\n }\n\n if (\n typeof navigator === \"undefined\" ||\n typeof navigator.sendBeacon !== \"function\"\n ) {\n return false;\n }\n\n const events = queue.slice(0, resolvedConfig.batchSize);\n\n try {\n const body = createPayload(resolvedConfig, events);\n const blob = new Blob([body], { type: JSON_CONTENT_TYPE_HEADER });\n const sent = navigator.sendBeacon(resolvedConfig.endpoint, blob);\n\n if (sent) {\n queue = queue.slice(events.length);\n persistQueue();\n }\n\n return sent;\n } catch {\n return false;\n }\n };\n\n const flush = async (): Promise<void> => {\n if (isDestroyed || !resolvedConfig.enabled || !resolvedConfig.endpoint) {\n return;\n }\n\n if (queue.length === 0) {\n return;\n }\n\n if (isFlushing) {\n flushQueuedAfterCurrent = true;\n return;\n }\n\n const events = queue.slice(0, resolvedConfig.batchSize);\n const body = createPayload(resolvedConfig, events);\n\n isFlushing = true;\n\n try {\n await resolvedConfig.transport({\n endpoint: resolvedConfig.endpoint,\n body,\n headers: resolvedConfig.headers,\n keepalive: true,\n });\n\n queue = queue.slice(events.length);\n persistQueue();\n } catch (error) {\n resolvedConfig.onError?.(error);\n } finally {\n isFlushing = false;\n\n if (flushQueuedAfterCurrent) {\n flushQueuedAfterCurrent = false;\n if (queue.length > 0) {\n void flush();\n }\n }\n }\n };\n\n const startFlushTimer = () => {\n if (flushTimer) {\n clearInterval(flushTimer);\n flushTimer = null;\n }\n\n if (!resolvedConfig.enabled) {\n return;\n }\n\n flushTimer = setInterval(() => {\n void flush();\n }, resolvedConfig.flushIntervalMs);\n };\n\n const handleVisibilityChange = () => {\n if (typeof document === \"undefined\") {\n return;\n }\n\n if (document.visibilityState !== \"hidden\") {\n return;\n }\n\n if (!flushWithBeacon()) {\n void flush();\n }\n };\n\n const handlePageHide = () => {\n if (!flushWithBeacon()) {\n void flush();\n }\n };\n\n if (isBrowserEnvironment()) {\n document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n window.addEventListener(\"pagehide\", handlePageHide);\n }\n\n startFlushTimer();\n\n const trackWithChannel = (\n event: Omit<LocalSpaceAnalyticsEvent, \"channel\">,\n channel: AnalyticsChannel\n ) => {\n const trackableEvent: LocalSpaceAnalyticsEvent = {\n ...event,\n channel,\n };\n track(trackableEvent);\n };\n\n const track = (event: LocalSpaceAnalyticsEvent) => {\n if (isDestroyed || !resolvedConfig.enabled) {\n return;\n }\n\n const eventChannel = event.channel ?? resolvedConfig.channel;\n const requestId =\n typeof event.requestId === \"string\" && event.requestId.trim()\n ? event.requestId.trim()\n : undefined;\n\n const record: LocalSpaceAnalyticsRecord = {\n id: createId(\"event\"),\n component: event.component,\n action: event.action,\n channel: eventChannel,\n runtime: resolvedConfig.runtime,\n label: event.label,\n href: event.href,\n variant: event.variant,\n requestId,\n source: resolvedConfig.source,\n sessionId: resolvedConfig.sessionId,\n timestamp: event.timestamp ?? Date.now(),\n context: createMergedContext(resolvedConfig, eventChannel, event.context),\n };\n\n queue.push(record);\n trimQueue();\n persistQueue();\n\n if (queue.length >= resolvedConfig.batchSize) {\n void flush();\n }\n };\n\n return {\n get source() {\n return resolvedConfig.source;\n },\n\n get channel() {\n return resolvedConfig.channel;\n },\n\n track,\n\n trackFrontend(event) {\n trackWithChannel(event, \"frontend\");\n },\n\n trackBackend(event) {\n trackWithChannel(event, \"backend\");\n },\n\n flush,\n\n updateConfig(nextConfig: Partial<LocalSpaceAnalyticsConfig>) {\n if (isDestroyed) {\n return;\n }\n\n const previousStorageKey = resolvedConfig.storageKey;\n resolvedConfig = resolveConfig(\n {\n ...resolvedConfig,\n ...nextConfig,\n source: nextConfig.source ?? resolvedConfig.source,\n },\n resolvedConfig\n );\n\n if (previousStorageKey !== resolvedConfig.storageKey) {\n writeQueue(previousStorageKey, []);\n persistQueue();\n }\n\n startFlushTimer();\n\n if (resolvedConfig.endpoint && queue.length > 0) {\n void flush();\n }\n },\n\n getConfig() {\n return resolvedConfig;\n },\n\n destroy() {\n if (isDestroyed) {\n return;\n }\n\n isDestroyed = true;\n\n if (flushTimer) {\n clearInterval(flushTimer);\n flushTimer = null;\n }\n\n if (isBrowserEnvironment()) {\n document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n window.removeEventListener(\"pagehide\", handlePageHide);\n }\n\n void flush();\n },\n };\n}\n\ntype ChannelPinnedConfig = Omit<LocalSpaceAnalyticsConfig, \"channel\" | \"runtime\"> & {\n runtime?: AnalyticsRuntime;\n};\n\nexport function createFrontendAnalyticsClient(\n config: ChannelPinnedConfig\n): LocalSpaceAnalyticsClient {\n return createLocalSpaceAnalyticsClient({\n ...config,\n channel: \"frontend\",\n runtime: config.runtime ?? \"browser\",\n });\n}\n\nexport function createBackendAnalyticsClient(\n config: ChannelPinnedConfig\n): LocalSpaceAnalyticsClient {\n return createLocalSpaceAnalyticsClient({\n ...config,\n channel: \"backend\",\n runtime: config.runtime ?? \"server\",\n });\n}\n\nexport function createNoopLocalSpaceAnalyticsClient(\n source = \"noop\",\n channel: AnalyticsChannel = \"frontend\"\n): LocalSpaceAnalyticsClient {\n const runtime = isBrowserEnvironment() ? \"browser\" : \"server\";\n const noopConfig: ResolvedLocalSpaceAnalyticsConfig = {\n source,\n channel,\n runtime,\n sessionId: createId(\"session\"),\n injectChannelContext: true,\n enabled: false,\n endpoint: undefined,\n defaultContext: {},\n headers: { \"content-type\": JSON_CONTENT_TYPE_HEADER },\n flushIntervalMs: DEFAULT_FLUSH_INTERVAL_MS,\n batchSize: DEFAULT_BATCH_SIZE,\n maxQueueSize: DEFAULT_MAX_QUEUE_SIZE,\n storageKey: buildDefaultStorageKey(source, channel),\n transport: async () => undefined,\n onError: undefined,\n };\n\n return {\n source,\n channel,\n track: () => undefined,\n trackFrontend: () => undefined,\n trackBackend: () => undefined,\n flush: async () => undefined,\n updateConfig: () => undefined,\n getConfig: () => noopConfig,\n destroy: () => undefined,\n };\n}\n","import { createContext, useContext, useEffect, useMemo, type ReactNode } from \"react\";\nimport {\n createLocalSpaceAnalyticsClient,\n createNoopLocalSpaceAnalyticsClient,\n} from \"../core/client.js\";\nimport type {\n LocalSpaceAnalyticsClient,\n LocalSpaceAnalyticsConfig,\n LocalSpaceAnalyticsEvent,\n} from \"../core/types.js\";\n\nexport interface AnalyticsProviderProps {\n children: ReactNode;\n source?: string;\n endpoint?: string;\n channel?: LocalSpaceAnalyticsConfig[\"channel\"];\n runtime?: LocalSpaceAnalyticsConfig[\"runtime\"];\n sessionId?: string;\n injectChannelContext?: boolean;\n enabled?: boolean;\n defaultContext?: LocalSpaceAnalyticsConfig[\"defaultContext\"];\n headers?: LocalSpaceAnalyticsConfig[\"headers\"];\n flushIntervalMs?: number;\n batchSize?: number;\n maxQueueSize?: number;\n storageKey?: string;\n transport?: LocalSpaceAnalyticsConfig[\"transport\"];\n onError?: LocalSpaceAnalyticsConfig[\"onError\"];\n client?: LocalSpaceAnalyticsClient;\n}\n\nexport interface AnalyticsContextValue {\n client: LocalSpaceAnalyticsClient;\n trackInteraction: (event: LocalSpaceAnalyticsEvent) => void;\n flush: () => Promise<void>;\n}\n\nconst AnalyticsContext = createContext<AnalyticsContextValue | null>(null);\n\nexport function AnalyticsProvider({\n children,\n source = \"react-app\",\n endpoint,\n channel,\n runtime,\n sessionId,\n injectChannelContext,\n enabled = true,\n defaultContext,\n headers,\n flushIntervalMs,\n batchSize,\n maxQueueSize,\n storageKey,\n transport,\n onError,\n client,\n}: AnalyticsProviderProps) {\n const managedClient = useMemo(() => {\n if (client) {\n return client;\n }\n\n if (!enabled) {\n return createNoopLocalSpaceAnalyticsClient(source);\n }\n\n return createLocalSpaceAnalyticsClient({\n source,\n endpoint,\n channel,\n runtime,\n sessionId,\n injectChannelContext,\n enabled,\n defaultContext,\n headers,\n flushIntervalMs,\n batchSize,\n maxQueueSize,\n storageKey,\n transport,\n onError,\n });\n }, [\n client,\n source,\n endpoint,\n channel,\n runtime,\n sessionId,\n injectChannelContext,\n enabled,\n defaultContext,\n headers,\n flushIntervalMs,\n batchSize,\n maxQueueSize,\n storageKey,\n transport,\n onError,\n ]);\n\n useEffect(() => {\n return () => {\n if (!client) {\n managedClient.destroy();\n }\n };\n }, [client, managedClient]);\n\n const value = useMemo<AnalyticsContextValue>(\n () => ({\n client: managedClient,\n trackInteraction: (event: LocalSpaceAnalyticsEvent) => {\n managedClient.track(event);\n },\n flush: () => managedClient.flush(),\n }),\n [managedClient]\n );\n\n return <AnalyticsContext.Provider value={value}>{children}</AnalyticsContext.Provider>;\n}\n\nexport function useAnalytics(): AnalyticsContextValue {\n const context = useContext(AnalyticsContext);\n\n if (!context) {\n throw new Error(\"useAnalytics must be used within AnalyticsProvider.\");\n }\n\n return context;\n}\n","import { useCallback } from \"react\";\nimport type { AnalyticsContext, LocalSpaceAnalyticsEvent } from \"../core/types.js\";\nimport { useAnalytics } from \"./provider.js\";\n\nexport interface TrackInteractionDetails\n extends Omit<LocalSpaceAnalyticsEvent, \"component\" | \"action\" | \"context\"> {\n context?: AnalyticsContext;\n}\n\nexport function useComponentInteractionTracker(\n component: string,\n baseContext: AnalyticsContext = {}\n): (action: string, details?: TrackInteractionDetails) => void {\n const { trackInteraction } = useAnalytics();\n\n return useCallback(\n (action: string, details?: TrackInteractionDetails) => {\n trackInteraction({\n component,\n action,\n channel: details?.channel,\n label: details?.label,\n href: details?.href,\n variant: details?.variant,\n requestId: details?.requestId,\n timestamp: details?.timestamp,\n context: {\n ...baseContext,\n ...(details?.context ?? {}),\n },\n });\n },\n [baseContext, component, trackInteraction]\n );\n}\n"],"mappings":"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","names":[]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@plasius/analytics",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.1.0",
|
|
4
4
|
"description": "Local-space analytics client and React helpers for interaction/event tracking with configurable ingestion endpoints.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"sideEffects": false,
|
|
@@ -50,6 +50,7 @@
|
|
|
50
50
|
"react": "^19"
|
|
51
51
|
},
|
|
52
52
|
"devDependencies": {
|
|
53
|
+
"@testing-library/dom": "^10.0.0",
|
|
53
54
|
"@testing-library/react": "^16.3.0",
|
|
54
55
|
"@types/node": "^24.3.1",
|
|
55
56
|
"@types/react": "^19.1.8",
|