@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 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 { createLocalSpaceAnalyticsClient } from "@plasius/analytics";
30
+ import {
31
+ createBackendAnalyticsClient,
32
+ createFrontendAnalyticsClient,
33
+ } from "@plasius/analytics";
30
34
 
31
- const analytics = createLocalSpaceAnalyticsClient({
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
- analytics.track({
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
- await analytics.flush();
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 DEFAULT_STORAGE_KEY = "plasius.analytics.local-space.queue";
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: config.endpoint?.trim(),
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 ?? previous?.storageKey ?? DEFAULT_STORAGE_KEY).trim(),
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 isBrowserEnvironment() {
99
- return typeof window !== "undefined" && typeof document !== "undefined";
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(source, events) {
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
- const sessionId = createId("session");
149
- let queue = readQueue(resolvedConfig.storageKey).slice(-resolvedConfig.maxQueueSize);
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.source, events);
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.source, events);
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
- track(event) {
255
- if (isDestroyed || !resolvedConfig.enabled) {
256
- return;
257
- }
258
- const record = {
259
- id: createId("event"),
260
- component: event.component,
261
- action: event.action,
262
- label: event.label,
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 createNoopLocalSpaceAnalyticsClient(source = "noop") {
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: DEFAULT_STORAGE_KEY,
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,
@@ -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
- declare function createNoopLocalSpaceAnalyticsClient(source?: string): LocalSpaceAnalyticsClient;
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
- declare function createNoopLocalSpaceAnalyticsClient(source?: string): LocalSpaceAnalyticsClient;
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 DEFAULT_STORAGE_KEY = "plasius.analytics.local-space.queue";
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: config.endpoint?.trim(),
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 ?? previous?.storageKey ?? DEFAULT_STORAGE_KEY).trim(),
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 isBrowserEnvironment() {
69
- return typeof window !== "undefined" && typeof document !== "undefined";
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(source, events) {
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
- const sessionId = createId("session");
119
- let queue = readQueue(resolvedConfig.storageKey).slice(-resolvedConfig.maxQueueSize);
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.source, events);
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.source, events);
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
- track(event) {
225
- if (isDestroyed || !resolvedConfig.enabled) {
226
- return;
227
- }
228
- const record = {
229
- id: createId("event"),
230
- component: event.component,
231
- action: event.action,
232
- label: event.label,
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 createNoopLocalSpaceAnalyticsClient(source = "noop") {
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: DEFAULT_STORAGE_KEY,
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.0.0",
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",