@trichidata/react 0.4.3 → 0.6.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
@@ -27,12 +27,7 @@ function Dashboard() {
27
27
  const client = useTrichiData();
28
28
 
29
29
  const handleClick = async () => {
30
- await client.trackEvent({
31
- type: 'page',
32
- eventId: crypto.randomUUID(),
33
- timestamp: Date.now(),
34
- properties: { url: '/dashboard' },
35
- });
30
+ await client.page({ url: '/dashboard' });
36
31
  };
37
32
 
38
33
  return <button onClick={handleClick}>Track page view</button>;
@@ -42,24 +37,44 @@ function Dashboard() {
42
37
  ## Standalone client (without Provider)
43
38
 
44
39
  ```ts
45
- import { TrichiDataClient, SDK_VERSION } from '@trichidata/react';
40
+ import { TrichiDataClient } from '@trichidata/react';
46
41
 
47
42
  const client = new TrichiDataClient({
48
43
  apiKey: 'prj_ak_xxxxxxxxxxxx',
49
- baseUrl: 'https://sdk-api.trichidata.com',
50
- sessionStrategy: 'browser',
51
44
  });
52
45
 
53
- await client.init({
54
- timestamp: Date.now(),
55
- device: {
56
- ip: '0.0.0.0',
57
- userAgent: navigator.userAgent,
58
- },
59
- sdkVersion: SDK_VERSION,
60
- });
46
+ await client.init();
47
+ ```
48
+
49
+ ## What is new in 0.6.0
50
+
51
+ - **Event queue.** Track methods return `{ eventId }` immediately; events are persisted in `localStorage`, sent in batches (every 5 s or 20 events) with retry/backoff, and flushed with `keepalive` when the page is hidden. Call `await client.flush()` to send now.
52
+ - **Anonymous id and sessions.** A persistent `anonymousId` and a `clientSessionId` (new after 30 minutes of inactivity) are attached to every event. Call `await client.reset()` on logout.
53
+ - **Safari ITP friendly.** The server session id is also sent as the `X-TrichiData-Session` header; the cookie keeps working.
54
+ - **Automatic pageviews.** The provider tracks a `page` event on mount and on every SPA navigation (`history.pushState` / `replaceState` / `popstate`, de-duplicated by URL). Pass `autoPageviews={false}` if you call `client.page()` yourself.
55
+ - **Attribution.** UTM parameters, click ids, referrer and landing page are captured automatically (first touch once per device, last touch per session).
56
+ - **Consent.** `requireConsent` holds back all tracking until `client.setConsent({ analytics: true })`.
57
+ - **StrictMode safe.** `TrichiDataProvider` initialises the client once, even when React runs effects twice in development.
58
+
59
+ ```tsx
60
+ <TrichiDataProvider
61
+ apiKey="prj_ak_xxxxxxxxxxxx"
62
+ autoPageviews // default: true
63
+ requireConsent={false} // default: false
64
+ >
65
+ <App />
66
+ </TrichiDataProvider>
67
+ ```
68
+
69
+ ```tsx
70
+ function CookieBanner() {
71
+ const client = useTrichiData();
72
+ return <button onClick={() => client.setConsent({ analytics: true })}>Accept</button>;
73
+ }
61
74
  ```
62
75
 
76
+ The device IP is no longer sent from the browser; the server uses the request IP.
77
+
63
78
  ## Scripts
64
79
 
65
80
  | Command | Description |
@@ -69,9 +84,3 @@ await client.init({
69
84
  | `npm run lint` | Run ESLint |
70
85
  | `npm run format` | Format with Prettier |
71
86
  | `npm run typecheck` | TypeScript check |
72
-
73
- ## Breaking changes in 0.2.0
74
-
75
- - `TrichiDataSdk` renamed to `TrichiDataClient` (from `@trichidata/core`)
76
- - `TrichiDataApiError` renamed to `TrichiDataError` (alias kept for compatibility)
77
- - Core logic moved to `@trichidata/core@^0.2.0`
package/dist/index.cjs CHANGED
@@ -5,11 +5,8 @@ var core = require('@trichidata/core');
5
5
  var jsxRuntime = require('react/jsx-runtime');
6
6
 
7
7
  // src/react/TrichiDataProvider.tsx
8
-
9
- // src/utils.ts
10
8
  function getDefaultDeviceInfo() {
11
9
  return {
12
- ip: "0.0.0.0",
13
10
  userAgent: typeof navigator !== "undefined" ? navigator.userAgent : "unknown",
14
11
  locale: typeof navigator !== "undefined" ? navigator.language : "en-US",
15
12
  timezone: typeof Intl !== "undefined" ? Intl.DateTimeFormat().resolvedOptions().timeZone : "UTC"
@@ -25,27 +22,255 @@ function getPageContext() {
25
22
  referrer: document.referrer || void 0
26
23
  };
27
24
  }
25
+ function getBrowserContext() {
26
+ if (typeof document === "undefined" || typeof window === "undefined") {
27
+ return {};
28
+ }
29
+ return {
30
+ screen: window.location.pathname,
31
+ url: window.location.href,
32
+ title: document.title,
33
+ referrer: document.referrer || void 0
34
+ };
35
+ }
36
+ function createBrowserStorage() {
37
+ const memory = new core.MemoryStorage();
38
+ let probed;
39
+ const local = () => {
40
+ try {
41
+ return typeof localStorage === "undefined" ? null : localStorage;
42
+ } catch {
43
+ return null;
44
+ }
45
+ };
46
+ const probe = () => {
47
+ try {
48
+ const storage = local();
49
+ if (!storage) return false;
50
+ storage.setItem("td_probe", "1");
51
+ storage.removeItem("td_probe");
52
+ return true;
53
+ } catch {
54
+ return false;
55
+ }
56
+ };
57
+ return {
58
+ get persistent() {
59
+ if (probed === void 0) probed = probe();
60
+ return probed;
61
+ },
62
+ getItem(key) {
63
+ try {
64
+ const value = local()?.getItem(key);
65
+ if (value !== void 0 && value !== null) return value;
66
+ } catch {
67
+ }
68
+ return memory.getItem(key);
69
+ },
70
+ setItem(key, value) {
71
+ try {
72
+ const storage = local();
73
+ if (storage) {
74
+ storage.setItem(key, value);
75
+ return;
76
+ }
77
+ } catch {
78
+ try {
79
+ local()?.removeItem(key);
80
+ } catch {
81
+ }
82
+ }
83
+ memory.setItem(key, value);
84
+ },
85
+ removeItem(key) {
86
+ try {
87
+ local()?.removeItem(key);
88
+ } catch {
89
+ }
90
+ memory.removeItem(key);
91
+ }
92
+ };
93
+ }
94
+ function createBrowserLifecycle() {
95
+ return {
96
+ onBackground(callback) {
97
+ if (typeof document === "undefined" || typeof window === "undefined") {
98
+ return () => void 0;
99
+ }
100
+ const onVisibility = () => {
101
+ if (document.visibilityState === "hidden") callback();
102
+ };
103
+ window.addEventListener("pagehide", callback);
104
+ document.addEventListener("visibilitychange", onVisibility);
105
+ return () => {
106
+ window.removeEventListener("pagehide", callback);
107
+ document.removeEventListener("visibilitychange", onVisibility);
108
+ };
109
+ }
110
+ };
111
+ }
112
+ function watchNavigation(onNavigate) {
113
+ if (typeof window === "undefined" || typeof history === "undefined") {
114
+ return () => void 0;
115
+ }
116
+ let lastUrl = window.location.href;
117
+ let timer = null;
118
+ const check = () => {
119
+ if (timer !== null) clearTimeout(timer);
120
+ timer = setTimeout(() => {
121
+ timer = null;
122
+ const url = window.location.href;
123
+ if (url === lastUrl) return;
124
+ const previous = lastUrl;
125
+ lastUrl = url;
126
+ onNavigate(url, previous);
127
+ }, 0);
128
+ };
129
+ const originalPush = history.pushState;
130
+ const originalReplace = history.replaceState;
131
+ const push = function(...args) {
132
+ const result = originalPush.apply(this, args);
133
+ check();
134
+ return result;
135
+ };
136
+ const replace = function(...args) {
137
+ const result = originalReplace.apply(this, args);
138
+ check();
139
+ return result;
140
+ };
141
+ history.pushState = push;
142
+ history.replaceState = replace;
143
+ window.addEventListener("popstate", check);
144
+ return () => {
145
+ if (timer !== null) clearTimeout(timer);
146
+ if (history.pushState === push) history.pushState = originalPush;
147
+ if (history.replaceState === replace) history.replaceState = originalReplace;
148
+ window.removeEventListener("popstate", check);
149
+ };
150
+ }
151
+
152
+ // src/client.ts
153
+ var TrichiDataClient = class extends core.TrichiDataClient {
154
+ autoPageviews;
155
+ stopNavigation = null;
156
+ /** The initial pageview was dropped because consent was not granted yet. */
157
+ landingPageDropped = false;
158
+ lastAutoPageUrl;
159
+ constructor(options) {
160
+ const { autoPageviews, ...coreOptions } = options;
161
+ super({
162
+ storage: createBrowserStorage(),
163
+ lifecycle: createBrowserLifecycle(),
164
+ platform: "web",
165
+ getContext: getBrowserContext,
166
+ ...coreOptions,
167
+ sessionStrategy: "browser"
168
+ });
169
+ this.autoPageviews = autoPageviews ?? true;
170
+ }
171
+ async init(params) {
172
+ const device = { ...getDefaultDeviceInfo(), ...params?.device };
173
+ const autoTracking = getDefaultTrackingContext();
174
+ const tracking = core.mergeTracking(autoTracking, params?.tracking);
175
+ this.startAutoPageviews();
176
+ return super.init({
177
+ timestamp: params?.timestamp,
178
+ device,
179
+ tracking
180
+ });
181
+ }
182
+ async shutdown() {
183
+ this.stopNavigation?.();
184
+ this.stopNavigation = null;
185
+ await super.shutdown();
186
+ }
187
+ async setConsent(state) {
188
+ await super.setConsent(state);
189
+ if (state.analytics && this.landingPageDropped && this.stopNavigation) {
190
+ this.landingPageDropped = false;
191
+ void this.page();
192
+ }
193
+ }
194
+ async page(properties, options) {
195
+ const pageContext = getPageContext();
196
+ return super.page(
197
+ {
198
+ url: properties?.url ?? pageContext.url,
199
+ referrer: properties?.referrer ?? pageContext.referrer,
200
+ title: properties?.title ?? pageContext.title
201
+ },
202
+ options
203
+ );
204
+ }
205
+ startAutoPageviews() {
206
+ if (!this.autoPageviews || this.stopNavigation) return;
207
+ const url = getPageContext().url;
208
+ if (url === void 0 || url !== this.lastAutoPageUrl) {
209
+ this.lastAutoPageUrl = url;
210
+ void this.page();
211
+ void this.isTrackingAllowed().then((allowed) => {
212
+ if (!allowed) this.landingPageDropped = true;
213
+ });
214
+ }
215
+ this.stopNavigation = watchNavigation((url2, previousUrl) => {
216
+ this.lastAutoPageUrl = url2;
217
+ void this.page({ referrer: previousUrl });
218
+ });
219
+ }
220
+ };
221
+ function getDefaultTrackingContext() {
222
+ if (typeof document === "undefined") {
223
+ return {};
224
+ }
225
+ return core.parseTrackingFromCookies({
226
+ cookieHeader: document.cookie,
227
+ url: typeof window !== "undefined" ? window.location.href : void 0
228
+ });
229
+ }
28
230
  var TrichiDataContext = react.createContext(null);
29
231
  function TrichiDataProvider({
30
232
  children,
31
233
  autoInit = true,
32
- apiKey,
33
- baseUrl,
34
- device
234
+ device,
235
+ tracking,
236
+ ...clientOptions
35
237
  }) {
238
+ const { apiKey, autoPageviews, requireConsent, baseUrl } = clientOptions;
36
239
  const client = react.useMemo(
37
- () => new core.TrichiDataClient({ apiKey, baseUrl, sessionStrategy: "browser" }),
38
- [apiKey, baseUrl]
240
+ () => new TrichiDataClient(clientOptions),
241
+ [apiKey, autoPageviews, requireConsent, baseUrl]
39
242
  );
243
+ const latest = react.useRef({ device, tracking });
244
+ latest.current = { device, tracking };
245
+ const initializedClient = react.useRef(null);
246
+ const pendingDispose = react.useRef(null);
247
+ const disposedClient = react.useRef(null);
40
248
  react.useEffect(() => {
41
- if (autoInit) {
42
- void client.init({
43
- timestamp: Date.now(),
44
- device: { ...getDefaultDeviceInfo(), ...device },
45
- sdkVersion: core.SDK_VERSION
249
+ const pending = pendingDispose.current;
250
+ if (pending?.client === client) {
251
+ clearTimeout(pending.timer);
252
+ pendingDispose.current = null;
253
+ } else if (autoInit && disposedClient.current === client) {
254
+ disposedClient.current = null;
255
+ initializedClient.current = null;
256
+ }
257
+ if (autoInit && initializedClient.current !== client) {
258
+ initializedClient.current = client;
259
+ void client.init(latest.current).catch((error) => {
260
+ clientOptions.onError?.(error);
46
261
  });
47
262
  }
48
- }, [autoInit, client, device]);
263
+ return () => {
264
+ const timer = setTimeout(() => {
265
+ if (pendingDispose.current?.client === client) pendingDispose.current = null;
266
+ disposedClient.current = client;
267
+ client.shutdown().catch((error) => {
268
+ clientOptions.onError?.(error);
269
+ });
270
+ }, 0);
271
+ pendingDispose.current = { client, timer };
272
+ };
273
+ }, [autoInit, client]);
49
274
  return /* @__PURE__ */ jsxRuntime.jsx(TrichiDataContext.Provider, { value: client, children });
50
275
  }
51
276
  function useTrichiData() {
@@ -56,60 +281,17 @@ function useTrichiData() {
56
281
  return client;
57
282
  }
58
283
 
59
- Object.defineProperty(exports, "API_PREFIX", {
60
- enumerable: true,
61
- get: function () { return core.API_PREFIX; }
62
- });
63
- Object.defineProperty(exports, "DEFAULT_BASE_URL", {
64
- enumerable: true,
65
- get: function () { return core.DEFAULT_BASE_URL; }
66
- });
67
- Object.defineProperty(exports, "HttpClient", {
68
- enumerable: true,
69
- get: function () { return core.HttpClient; }
70
- });
71
- Object.defineProperty(exports, "SDK_VERSION", {
72
- enumerable: true,
73
- get: function () { return core.SDK_VERSION; }
74
- });
75
284
  Object.defineProperty(exports, "TrichiDataApiError", {
76
285
  enumerable: true,
77
286
  get: function () { return core.TrichiDataError; }
78
287
  });
79
- Object.defineProperty(exports, "TrichiDataClient", {
80
- enumerable: true,
81
- get: function () { return core.TrichiDataClient; }
82
- });
83
288
  Object.defineProperty(exports, "TrichiDataError", {
84
289
  enumerable: true,
85
290
  get: function () { return core.TrichiDataError; }
86
291
  });
87
- Object.defineProperty(exports, "createEventId", {
88
- enumerable: true,
89
- get: function () { return core.createEventId; }
90
- });
91
- Object.defineProperty(exports, "identify", {
92
- enumerable: true,
93
- get: function () { return core.identify; }
94
- });
95
- Object.defineProperty(exports, "initSdk", {
96
- enumerable: true,
97
- get: function () { return core.initSdk; }
98
- });
99
- Object.defineProperty(exports, "nowTimestamp", {
100
- enumerable: true,
101
- get: function () { return core.nowTimestamp; }
102
- });
103
- Object.defineProperty(exports, "trackEvent", {
104
- enumerable: true,
105
- get: function () { return core.trackEvent; }
106
- });
107
- Object.defineProperty(exports, "trackEventsBatch", {
108
- enumerable: true,
109
- get: function () { return core.trackEventsBatch; }
110
- });
292
+ exports.TrichiDataClient = TrichiDataClient;
111
293
  exports.TrichiDataProvider = TrichiDataProvider;
112
- exports.getDefaultDeviceInfo = getDefaultDeviceInfo;
294
+ exports.getDefaultTrackingContext = getDefaultTrackingContext;
113
295
  exports.getPageContext = getPageContext;
114
296
  exports.useTrichiData = useTrichiData;
115
297
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/utils.ts","../src/react/TrichiDataProvider.tsx"],"names":["createContext","useMemo","TrichiDataClient","useEffect","SDK_VERSION","useContext"],"mappings":";;;;;;;;;AAAO,SAAS,oBAAA,GAKd;AACA,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,SAAA;AAAA,IACJ,SAAA,EAAW,OAAO,SAAA,KAAc,WAAA,GAAc,UAAU,SAAA,GAAY,SAAA;AAAA,IACpE,MAAA,EAAQ,OAAO,SAAA,KAAc,WAAA,GAAc,UAAU,QAAA,GAAW,OAAA;AAAA,IAChE,QAAA,EACE,OAAO,IAAA,KAAS,WAAA,GAAc,KAAK,cAAA,EAAe,CAAE,eAAA,EAAgB,CAAE,QAAA,GAAW;AAAA,GACrF;AACF;AAEO,SAAS,cAAA,GAId;AACA,EAAA,IAAI,OAAO,QAAA,KAAa,WAAA,IAAe,OAAO,WAAW,WAAA,EAAa;AACpE,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,OAAO;AAAA,IACL,OAAO,QAAA,CAAS,KAAA;AAAA,IAChB,GAAA,EAAK,OAAO,QAAA,CAAS,IAAA;AAAA,IACrB,QAAA,EAAU,SAAS,QAAA,IAAY;AAAA,GACjC;AACF;ACpBA,IAAM,iBAAA,GAAoBA,oBAAuC,IAAI,CAAA;AAQ9D,SAAS,kBAAA,CAAmB;AAAA,EACjC,QAAA;AAAA,EACA,QAAA,GAAW,IAAA;AAAA,EACX,MAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF,CAAA,EAA4B;AAC1B,EAAA,MAAM,MAAA,GAASC,aAAA;AAAA,IACb,MAAM,IAAIC,qBAAA,CAAiB,EAAE,QAAQ,OAAA,EAAS,eAAA,EAAiB,WAAW,CAAA;AAAA,IAC1E,CAAC,QAAQ,OAAO;AAAA,GAClB;AAEA,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,KAAK,OAAO,IAAA,CAAK;AAAA,QACf,SAAA,EAAW,KAAK,GAAA,EAAI;AAAA,QACpB,QAAQ,EAAE,GAAG,oBAAA,EAAqB,EAAG,GAAG,MAAA,EAAO;AAAA,QAC/C,UAAA,EAAYC;AAAA,OACb,CAAA;AAAA,IACH;AAAA,EACF,CAAA,EAAG,CAAC,QAAA,EAAU,MAAA,EAAQ,MAAM,CAAC,CAAA;AAE7B,EAAA,sCAAQ,iBAAA,CAAkB,QAAA,EAAlB,EAA2B,KAAA,EAAO,QAAS,QAAA,EAAS,CAAA;AAC9D;AAEO,SAAS,aAAA,GAAkC;AAChD,EAAA,MAAM,MAAA,GAASC,iBAAW,iBAAiB,CAAA;AAE3C,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,MAAM,wDAAwD,CAAA;AAAA,EAC1E;AAEA,EAAA,OAAO,MAAA;AACT","file":"index.cjs","sourcesContent":["export function getDefaultDeviceInfo(): {\n ip: string;\n userAgent: string;\n locale: string;\n timezone: string;\n} {\n return {\n ip: '0.0.0.0',\n userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : 'unknown',\n locale: typeof navigator !== 'undefined' ? navigator.language : 'en-US',\n timezone:\n typeof Intl !== 'undefined' ? Intl.DateTimeFormat().resolvedOptions().timeZone : 'UTC',\n };\n}\n\nexport function getPageContext(): {\n title?: string;\n url?: string;\n referrer?: string;\n} {\n if (typeof document === 'undefined' || typeof window === 'undefined') {\n return {};\n }\n\n return {\n title: document.title,\n url: window.location.href,\n referrer: document.referrer || undefined,\n };\n}\n","import { createContext, useContext, useEffect, useMemo, type ReactNode } from 'react';\nimport {\n SDK_VERSION,\n TrichiDataClient,\n type DeviceInfo,\n type TrichiDataClientOptions,\n} from '@trichidata/core';\nimport { getDefaultDeviceInfo } from '../utils';\n\nconst TrichiDataContext = createContext<TrichiDataClient | null>(null);\n\nexport interface TrichiDataProviderProps extends Omit<TrichiDataClientOptions, 'sessionStrategy'> {\n children: ReactNode;\n autoInit?: boolean;\n device?: Partial<DeviceInfo>;\n}\n\nexport function TrichiDataProvider({\n children,\n autoInit = true,\n apiKey,\n baseUrl,\n device,\n}: TrichiDataProviderProps) {\n const client = useMemo(\n () => new TrichiDataClient({ apiKey, baseUrl, sessionStrategy: 'browser' }),\n [apiKey, baseUrl],\n );\n\n useEffect(() => {\n if (autoInit) {\n void client.init({\n timestamp: Date.now(),\n device: { ...getDefaultDeviceInfo(), ...device },\n sdkVersion: SDK_VERSION,\n });\n }\n }, [autoInit, client, device]);\n\n return <TrichiDataContext.Provider value={client}>{children}</TrichiDataContext.Provider>;\n}\n\nexport function useTrichiData(): TrichiDataClient {\n const client = useContext(TrichiDataContext);\n\n if (!client) {\n throw new Error('useTrichiData must be used within a TrichiDataProvider');\n }\n\n return client;\n}\n"]}
1
+ {"version":3,"sources":["../src/utils.ts","../src/client.ts","../src/react/TrichiDataProvider.tsx"],"names":["MemoryStorage","CoreClient","mergeTracking","url","parseTrackingFromCookies","createContext","useMemo","useRef","useEffect","useContext"],"mappings":";;;;;;;AAEO,SAAS,oBAAA,GAId;AACA,EAAA,OAAO;AAAA,IACL,SAAA,EAAW,OAAO,SAAA,KAAc,WAAA,GAAc,UAAU,SAAA,GAAY,SAAA;AAAA,IACpE,MAAA,EAAQ,OAAO,SAAA,KAAc,WAAA,GAAc,UAAU,QAAA,GAAW,OAAA;AAAA,IAChE,QAAA,EACE,OAAO,IAAA,KAAS,WAAA,GAAc,KAAK,cAAA,EAAe,CAAE,eAAA,EAAgB,CAAE,QAAA,GAAW;AAAA,GACrF;AACF;AAEO,SAAS,cAAA,GAId;AACA,EAAA,IAAI,OAAO,QAAA,KAAa,WAAA,IAAe,OAAO,WAAW,WAAA,EAAa;AACpE,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,OAAO;AAAA,IACL,OAAO,QAAA,CAAS,KAAA;AAAA,IAChB,GAAA,EAAK,OAAO,QAAA,CAAS,IAAA;AAAA,IACrB,QAAA,EAAU,SAAS,QAAA,IAAY;AAAA,GACjC;AACF;AAGO,SAAS,iBAAA,GAAmC;AACjD,EAAA,IAAI,OAAO,QAAA,KAAa,WAAA,IAAe,OAAO,WAAW,WAAA,EAAa;AACpE,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,OAAO;AAAA,IACL,MAAA,EAAQ,OAAO,QAAA,CAAS,QAAA;AAAA,IACxB,GAAA,EAAK,OAAO,QAAA,CAAS,IAAA;AAAA,IACrB,OAAO,QAAA,CAAS,KAAA;AAAA,IAChB,QAAA,EAAU,SAAS,QAAA,IAAY;AAAA,GACjC;AACF;AAOO,SAAS,oBAAA,GAA0E;AACxF,EAAA,MAAM,MAAA,GAAS,IAAIA,kBAAA,EAAc;AACjC,EAAA,IAAI,MAAA;AAEJ,EAAA,MAAM,QAAQ,MAAsB;AAClC,IAAA,IAAI;AACF,MAAA,OAAO,OAAO,YAAA,KAAiB,WAAA,GAAc,IAAA,GAAO,YAAA;AAAA,IACtD,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,QAAQ,MAAe;AAC3B,IAAA,IAAI;AACF,MAAA,MAAM,UAAU,KAAA,EAAM;AACtB,MAAA,IAAI,CAAC,SAAS,OAAO,KAAA;AACrB,MAAA,OAAA,CAAQ,OAAA,CAAQ,YAAY,GAAG,CAAA;AAC/B,MAAA,OAAA,CAAQ,WAAW,UAAU,CAAA;AAC7B,MAAA,OAAO,IAAA;AAAA,IACT,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,IAAI,UAAA,GAAa;AACf,MAAA,IAAI,MAAA,KAAW,MAAA,EAAW,MAAA,GAAS,KAAA,EAAM;AACzC,MAAA,OAAO,MAAA;AAAA,IACT,CAAA;AAAA,IACA,QAAQ,GAAA,EAAK;AACX,MAAA,IAAI;AAEF,QAAA,MAAM,KAAA,GAAQ,KAAA,EAAM,EAAG,OAAA,CAAQ,GAAG,CAAA;AAClC,QAAA,IAAI,KAAA,KAAU,KAAA,CAAA,IAAa,KAAA,KAAU,IAAA,EAAM,OAAO,KAAA;AAAA,MACpD,CAAA,CAAA,MAAQ;AAAA,MAER;AACA,MAAA,OAAO,MAAA,CAAO,QAAQ,GAAG,CAAA;AAAA,IAC3B,CAAA;AAAA,IACA,OAAA,CAAQ,KAAK,KAAA,EAAO;AAClB,MAAA,IAAI;AACF,QAAA,MAAM,UAAU,KAAA,EAAM;AACtB,QAAA,IAAI,OAAA,EAAS;AACX,UAAA,OAAA,CAAQ,OAAA,CAAQ,KAAK,KAAK,CAAA;AAC1B,UAAA;AAAA,QACF;AAAA,MACF,CAAA,CAAA,MAAQ;AAEN,QAAA,IAAI;AACF,UAAA,KAAA,EAAM,EAAG,WAAW,GAAG,CAAA;AAAA,QACzB,CAAA,CAAA,MAAQ;AAAA,QAER;AAAA,MACF;AACA,MAAA,MAAA,CAAO,OAAA,CAAQ,KAAK,KAAK,CAAA;AAAA,IAC3B,CAAA;AAAA,IACA,WAAW,GAAA,EAAK;AACd,MAAA,IAAI;AACF,QAAA,KAAA,EAAM,EAAG,WAAW,GAAG,CAAA;AAAA,MACzB,CAAA,CAAA,MAAQ;AAAA,MAER;AACA,MAAA,MAAA,CAAO,WAAW,GAAG,CAAA;AAAA,IACvB;AAAA,GACF;AACF;AAGO,SAAS,sBAAA,GAEd;AACA,EAAA,OAAO;AAAA,IACL,aAAa,QAAA,EAAU;AACrB,MAAA,IAAI,OAAO,QAAA,KAAa,WAAA,IAAe,OAAO,WAAW,WAAA,EAAa;AACpE,QAAA,OAAO,MAAM,MAAA;AAAA,MACf;AAEA,MAAA,MAAM,eAAe,MAAM;AACzB,QAAA,IAAI,QAAA,CAAS,eAAA,KAAoB,QAAA,EAAU,QAAA,EAAS;AAAA,MACtD,CAAA;AAEA,MAAA,MAAA,CAAO,gBAAA,CAAiB,YAAY,QAAQ,CAAA;AAC5C,MAAA,QAAA,CAAS,gBAAA,CAAiB,oBAAoB,YAAY,CAAA;AAE1D,MAAA,OAAO,MAAM;AACX,QAAA,MAAA,CAAO,mBAAA,CAAoB,YAAY,QAAQ,CAAA;AAC/C,QAAA,QAAA,CAAS,mBAAA,CAAoB,oBAAoB,YAAY,CAAA;AAAA,MAC/D,CAAA;AAAA,IACF;AAAA,GACF;AACF;AAMO,SAAS,gBACd,UAAA,EACY;AACZ,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,OAAO,YAAY,WAAA,EAAa;AACnE,IAAA,OAAO,MAAM,MAAA;AAAA,EACf;AAEA,EAAA,IAAI,OAAA,GAAU,OAAO,QAAA,CAAS,IAAA;AAC9B,EAAA,IAAI,KAAA,GAA8C,IAAA;AAElD,EAAA,MAAM,QAAQ,MAAM;AAElB,IAAA,IAAI,KAAA,KAAU,IAAA,EAAM,YAAA,CAAa,KAAK,CAAA;AACtC,IAAA,KAAA,GAAQ,WAAW,MAAM;AACvB,MAAA,KAAA,GAAQ,IAAA;AACR,MAAA,MAAM,GAAA,GAAM,OAAO,QAAA,CAAS,IAAA;AAC5B,MAAA,IAAI,QAAQ,OAAA,EAAS;AACrB,MAAA,MAAM,QAAA,GAAW,OAAA;AACjB,MAAA,OAAA,GAAU,GAAA;AACV,MAAA,UAAA,CAAW,KAAK,QAAQ,CAAA;AAAA,IAC1B,GAAG,CAAC,CAAA;AAAA,EACN,CAAA;AAEA,EAAA,MAAM,eAAe,OAAA,CAAQ,SAAA;AAC7B,EAAA,MAAM,kBAAkB,OAAA,CAAQ,YAAA;AAEhC,EAAA,MAAM,IAAA,GAA6B,YAA4B,IAAA,EAAM;AACnE,IAAA,MAAM,MAAA,GAAS,YAAA,CAAa,KAAA,CAAM,IAAA,EAAM,IAAI,CAAA;AAC5C,IAAA,KAAA,EAAM;AACN,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AACA,EAAA,MAAM,OAAA,GAAmC,YAA4B,IAAA,EAAM;AACzE,IAAA,MAAM,MAAA,GAAS,eAAA,CAAgB,KAAA,CAAM,IAAA,EAAM,IAAI,CAAA;AAC/C,IAAA,KAAA,EAAM;AACN,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAA,CAAQ,SAAA,GAAY,IAAA;AACpB,EAAA,OAAA,CAAQ,YAAA,GAAe,OAAA;AACvB,EAAA,MAAA,CAAO,gBAAA,CAAiB,YAAY,KAAK,CAAA;AAEzC,EAAA,OAAO,MAAM;AACX,IAAA,IAAI,KAAA,KAAU,IAAA,EAAM,YAAA,CAAa,KAAK,CAAA;AACtC,IAAA,IAAI,OAAA,CAAQ,SAAA,KAAc,IAAA,EAAM,OAAA,CAAQ,SAAA,GAAY,YAAA;AACpD,IAAA,IAAI,OAAA,CAAQ,YAAA,KAAiB,OAAA,EAAS,OAAA,CAAQ,YAAA,GAAe,eAAA;AAC7D,IAAA,MAAA,CAAO,mBAAA,CAAoB,YAAY,KAAK,CAAA;AAAA,EAC9C,CAAA;AACF;;;AChKO,IAAM,gBAAA,GAAN,cAA+BC,qBAAA,CAAW;AAAA,EAC9B,aAAA;AAAA,EACT,cAAA,GAAsC,IAAA;AAAA;AAAA,EAEtC,kBAAA,GAAqB,KAAA;AAAA,EACrB,eAAA;AAAA,EAER,YAAY,OAAA,EAA6B;AACvC,IAAA,MAAM,EAAE,aAAA,EAAe,GAAG,WAAA,EAAY,GAAI,OAAA;AAC1C,IAAA,KAAA,CAAM;AAAA,MACJ,SAAS,oBAAA,EAAqB;AAAA,MAC9B,WAAW,sBAAA,EAAuB;AAAA,MAClC,QAAA,EAAU,KAAA;AAAA,MACV,UAAA,EAAY,iBAAA;AAAA,MACZ,GAAG,WAAA;AAAA,MACH,eAAA,EAAiB;AAAA,KAClB,CAAA;AACD,IAAA,IAAA,CAAK,gBAAgB,aAAA,IAAiB,IAAA;AAAA,EACxC;AAAA,EAEA,MAAM,KAAK,MAAA,EAAgD;AACzD,IAAA,MAAM,SAAS,EAAE,GAAG,sBAAqB,EAAG,GAAG,QAAQ,MAAA,EAAO;AAC9D,IAAA,MAAM,eAAe,yBAAA,EAA0B;AAC/C,IAAA,MAAM,QAAA,GAAWC,kBAAA,CAAc,YAAA,EAAc,MAAA,EAAQ,QAAQ,CAAA;AAG7D,IAAA,IAAA,CAAK,kBAAA,EAAmB;AAExB,IAAA,OAAO,MAAM,IAAA,CAAK;AAAA,MAChB,WAAW,MAAA,EAAQ,SAAA;AAAA,MACnB,MAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA,EAEA,MAAe,QAAA,GAA0B;AACvC,IAAA,IAAA,CAAK,cAAA,IAAiB;AACtB,IAAA,IAAA,CAAK,cAAA,GAAiB,IAAA;AACtB,IAAA,MAAM,MAAM,QAAA,EAAS;AAAA,EACvB;AAAA,EAEA,MAAe,WAAW,KAAA,EAAoC;AAC5D,IAAA,MAAM,KAAA,CAAM,WAAW,KAAK,CAAA;AAE5B,IAAA,IAAI,KAAA,CAAM,SAAA,IAAa,IAAA,CAAK,kBAAA,IAAsB,KAAK,cAAA,EAAgB;AACrE,MAAA,IAAA,CAAK,kBAAA,GAAqB,KAAA;AAC1B,MAAA,KAAK,KAAK,IAAA,EAAK;AAAA,IACjB;AAAA,EACF;AAAA,EAEA,MAAe,IAAA,CACb,UAAA,EACA,OAAA,EACyB;AACzB,IAAA,MAAM,cAAc,cAAA,EAAe;AACnC,IAAA,OAAO,KAAA,CAAM,IAAA;AAAA,MACX;AAAA,QACE,GAAA,EAAK,UAAA,EAAY,GAAA,IAAO,WAAA,CAAY,GAAA;AAAA,QACpC,QAAA,EAAU,UAAA,EAAY,QAAA,IAAY,WAAA,CAAY,QAAA;AAAA,QAC9C,KAAA,EAAO,UAAA,EAAY,KAAA,IAAS,WAAA,CAAY;AAAA,OAC1C;AAAA,MACA;AAAA,KACF;AAAA,EACF;AAAA,EAEQ,kBAAA,GAA2B;AACjC,IAAA,IAAI,CAAC,IAAA,CAAK,aAAA,IAAiB,IAAA,CAAK,cAAA,EAAgB;AAGhD,IAAA,MAAM,GAAA,GAAM,gBAAe,CAAE,GAAA;AAC7B,IAAA,IAAI,GAAA,KAAQ,MAAA,IAAa,GAAA,KAAQ,IAAA,CAAK,eAAA,EAAiB;AACrD,MAAA,IAAA,CAAK,eAAA,GAAkB,GAAA;AACvB,MAAA,KAAK,KAAK,IAAA,EAAK;AACf,MAAA,KAAK,IAAA,CAAK,iBAAA,EAAkB,CAAE,IAAA,CAAK,CAAC,OAAA,KAAY;AAC9C,QAAA,IAAI,CAAC,OAAA,EAAS,IAAA,CAAK,kBAAA,GAAqB,IAAA;AAAA,MAC1C,CAAC,CAAA;AAAA,IACH;AACA,IAAA,IAAA,CAAK,cAAA,GAAiB,eAAA,CAAgB,CAACC,IAAAA,EAAK,WAAA,KAAgB;AAC1D,MAAA,IAAA,CAAK,eAAA,GAAkBA,IAAAA;AAEvB,MAAA,KAAK,IAAA,CAAK,IAAA,CAAK,EAAE,QAAA,EAAU,aAAa,CAAA;AAAA,IAC1C,CAAC,CAAA;AAAA,EACH;AACF;AAEO,SAAS,yBAAA,GAA6C;AAC3D,EAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACnC,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,OAAOC,6BAAA,CAAyB;AAAA,IAC9B,cAAc,QAAA,CAAS,MAAA;AAAA,IACvB,KAAK,OAAO,MAAA,KAAW,WAAA,GAAc,MAAA,CAAO,SAAS,IAAA,GAAO;AAAA,GAC7D,CAAA;AACH;AC3HA,IAAM,iBAAA,GAAoBC,oBAAuC,IAAI,CAAA;AAS9D,SAAS,kBAAA,CAAmB;AAAA,EACjC,QAAA;AAAA,EACA,QAAA,GAAW,IAAA;AAAA,EACX,MAAA;AAAA,EACA,QAAA;AAAA,EACA,GAAG;AACL,CAAA,EAA4B;AAC1B,EAAA,MAAM,EAAE,MAAA,EAAQ,aAAA,EAAe,cAAA,EAAgB,SAAQ,GAAI,aAAA;AAC3D,EAAA,MAAM,MAAA,GAASC,aAAA;AAAA,IACb,MAAM,IAAI,gBAAA,CAAiB,aAAa,CAAA;AAAA,IACxC,CAAC,MAAA,EAAQ,aAAA,EAAe,cAAA,EAAgB,OAAO;AAAA,GACjD;AAEA,EAAA,MAAM,MAAA,GAASC,YAAA,CAAO,EAAE,MAAA,EAAQ,UAAU,CAAA;AAC1C,EAAA,MAAA,CAAO,OAAA,GAAU,EAAE,MAAA,EAAQ,QAAA,EAAS;AAEpC,EAAA,MAAM,iBAAA,GAAoBA,aAAgC,IAAI,CAAA;AAE9D,EAAA,MAAM,cAAA,GAAiBA,aAGb,IAAI,CAAA;AAEd,EAAA,MAAM,cAAA,GAAiBA,aAAgC,IAAI,CAAA;AAE3D,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,UAAU,cAAA,CAAe,OAAA;AAC/B,IAAA,IAAI,OAAA,EAAS,WAAW,MAAA,EAAQ;AAE9B,MAAA,YAAA,CAAa,QAAQ,KAAK,CAAA;AAC1B,MAAA,cAAA,CAAe,OAAA,GAAU,IAAA;AAAA,IAC3B,CAAA,MAAA,IAAW,QAAA,IAAY,cAAA,CAAe,OAAA,KAAY,MAAA,EAAQ;AACxD,MAAA,cAAA,CAAe,OAAA,GAAU,IAAA;AACzB,MAAA,iBAAA,CAAkB,OAAA,GAAU,IAAA;AAAA,IAC9B;AAEA,IAAA,IAAI,QAAA,IAAY,iBAAA,CAAkB,OAAA,KAAY,MAAA,EAAQ;AACpD,MAAA,iBAAA,CAAkB,OAAA,GAAU,MAAA;AAC5B,MAAA,KAAK,OAAO,IAAA,CAAK,MAAA,CAAO,OAAO,CAAA,CAAE,KAAA,CAAM,CAAC,KAAA,KAAmB;AACzD,QAAA,aAAA,CAAc,UAAU,KAAK,CAAA;AAAA,MAC/B,CAAC,CAAA;AAAA,IACH;AAEA,IAAA,OAAO,MAAM;AACX,MAAA,MAAM,KAAA,GAAQ,WAAW,MAAM;AAC7B,QAAA,IAAI,cAAA,CAAe,OAAA,EAAS,MAAA,KAAW,MAAA,iBAAuB,OAAA,GAAU,IAAA;AACxE,QAAA,cAAA,CAAe,OAAA,GAAU,MAAA;AACzB,QAAA,MAAA,CAAO,QAAA,EAAS,CAAE,KAAA,CAAM,CAAC,KAAA,KAAmB;AAC1C,UAAA,aAAA,CAAc,UAAU,KAAK,CAAA;AAAA,QAC/B,CAAC,CAAA;AAAA,MACH,GAAG,CAAC,CAAA;AACJ,MAAA,cAAA,CAAe,OAAA,GAAU,EAAE,MAAA,EAAQ,KAAA,EAAM;AAAA,IAC3C,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,QAAA,EAAU,MAAM,CAAC,CAAA;AAErB,EAAA,sCAAQ,iBAAA,CAAkB,QAAA,EAAlB,EAA2B,KAAA,EAAO,QAAS,QAAA,EAAS,CAAA;AAC9D;AAEO,SAAS,aAAA,GAAkC;AAChD,EAAA,MAAM,MAAA,GAASC,iBAAW,iBAAiB,CAAA;AAE3C,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,MAAM,wDAAwD,CAAA;AAAA,EAC1E;AAEA,EAAA,OAAO,MAAA;AACT","file":"index.cjs","sourcesContent":["import { MemoryStorage, type ClientContext, type StorageAdapter } from '@trichidata/core';\n\nexport function getDefaultDeviceInfo(): {\n userAgent: string;\n locale: string;\n timezone: string;\n} {\n return {\n userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : 'unknown',\n locale: typeof navigator !== 'undefined' ? navigator.language : 'en-US',\n timezone:\n typeof Intl !== 'undefined' ? Intl.DateTimeFormat().resolvedOptions().timeZone : 'UTC',\n };\n}\n\nexport function getPageContext(): {\n title?: string;\n url?: string;\n referrer?: string;\n} {\n if (typeof document === 'undefined' || typeof window === 'undefined') {\n return {};\n }\n\n return {\n title: document.title,\n url: window.location.href,\n referrer: document.referrer || undefined,\n };\n}\n\n/** Context read by the core client: screen = pathname, url/referrer feed attribution. */\nexport function getBrowserContext(): ClientContext {\n if (typeof document === 'undefined' || typeof window === 'undefined') {\n return {};\n }\n\n return {\n screen: window.location.pathname,\n url: window.location.href,\n title: document.title,\n referrer: document.referrer || undefined,\n };\n}\n\n/**\n * localStorage-backed storage; falls back to memory when unavailable (private mode, SSR).\n * `persistent` is true only if a probe write to localStorage succeeds (old Safari private\n * mode and a full quota throw on setItem, so data would silently live in memory).\n */\nexport function createBrowserStorage(): StorageAdapter & { readonly persistent: boolean } {\n const memory = new MemoryStorage();\n let probed: boolean | undefined;\n\n const local = (): Storage | null => {\n try {\n return typeof localStorage === 'undefined' ? null : localStorage;\n } catch {\n return null;\n }\n };\n\n const probe = (): boolean => {\n try {\n const storage = local();\n if (!storage) return false;\n storage.setItem('td_probe', '1');\n storage.removeItem('td_probe');\n return true;\n } catch {\n return false;\n }\n };\n\n return {\n get persistent() {\n if (probed === undefined) probed = probe();\n return probed;\n },\n getItem(key) {\n try {\n // getItem returns null for a missing key: then use the memory copy (written when setItem threw).\n const value = local()?.getItem(key);\n if (value !== undefined && value !== null) return value;\n } catch {\n // fall through to memory\n }\n return memory.getItem(key);\n },\n setItem(key, value) {\n try {\n const storage = local();\n if (storage) {\n storage.setItem(key, value);\n return;\n }\n } catch {\n // an older value left in localStorage would be read instead of the memory copy\n try {\n local()?.removeItem(key);\n } catch {\n // ignore\n }\n }\n memory.setItem(key, value);\n },\n removeItem(key) {\n try {\n local()?.removeItem(key);\n } catch {\n // ignore\n }\n memory.removeItem(key);\n },\n };\n}\n\n/** Flush when the page is hidden or being unloaded. */\nexport function createBrowserLifecycle(): {\n onBackground(callback: () => void): () => void;\n} {\n return {\n onBackground(callback) {\n if (typeof document === 'undefined' || typeof window === 'undefined') {\n return () => undefined;\n }\n\n const onVisibility = () => {\n if (document.visibilityState === 'hidden') callback();\n };\n\n window.addEventListener('pagehide', callback);\n document.addEventListener('visibilitychange', onVisibility);\n\n return () => {\n window.removeEventListener('pagehide', callback);\n document.removeEventListener('visibilitychange', onVisibility);\n };\n },\n };\n}\n\n/**\n * Track SPA navigations (history.pushState / replaceState / popstate).\n * `onNavigate(url, previousUrl)` fires once per distinct URL. Returns a stop function.\n */\nexport function watchNavigation(\n onNavigate: (url: string, previousUrl: string) => void,\n): () => void {\n if (typeof window === 'undefined' || typeof history === 'undefined') {\n return () => undefined;\n }\n\n let lastUrl = window.location.href;\n let timer: ReturnType<typeof setTimeout> | null = null;\n\n const check = () => {\n // let the app update document.title before we read it\n if (timer !== null) clearTimeout(timer);\n timer = setTimeout(() => {\n timer = null;\n const url = window.location.href;\n if (url === lastUrl) return;\n const previous = lastUrl;\n lastUrl = url;\n onNavigate(url, previous);\n }, 0);\n };\n\n const originalPush = history.pushState;\n const originalReplace = history.replaceState;\n\n const push: History['pushState'] = function (this: History, ...args) {\n const result = originalPush.apply(this, args);\n check();\n return result;\n };\n const replace: History['replaceState'] = function (this: History, ...args) {\n const result = originalReplace.apply(this, args);\n check();\n return result;\n };\n\n history.pushState = push;\n history.replaceState = replace;\n window.addEventListener('popstate', check);\n\n return () => {\n if (timer !== null) clearTimeout(timer);\n if (history.pushState === push) history.pushState = originalPush;\n if (history.replaceState === replace) history.replaceState = originalReplace;\n window.removeEventListener('popstate', check);\n };\n}\n","import {\n TrichiDataClient as CoreClient,\n mergeTracking,\n parseTrackingFromCookies,\n type ConsentState,\n type DeviceInfo,\n type InitSdkData,\n type PageProperties,\n type TrackEventData,\n type TrackingContext,\n type TrackOptions,\n type TrichiDataClientOptions,\n} from '@trichidata/core';\nimport {\n createBrowserLifecycle,\n createBrowserStorage,\n getBrowserContext,\n getDefaultDeviceInfo,\n getPageContext,\n watchNavigation,\n} from './utils';\n\nexport interface ReactInitParams {\n timestamp?: number;\n device?: Partial<DeviceInfo>;\n tracking?: TrackingContext;\n}\n\nexport interface ReactClientOptions extends TrichiDataClientOptions {\n /** Track a `page` event on init and on every SPA navigation (default: true) */\n autoPageviews?: boolean;\n}\n\nexport class TrichiDataClient extends CoreClient {\n private readonly autoPageviews: boolean;\n private stopNavigation: (() => void) | null = null;\n /** The initial pageview was dropped because consent was not granted yet. */\n private landingPageDropped = false;\n private lastAutoPageUrl: string | undefined;\n\n constructor(options: ReactClientOptions) {\n const { autoPageviews, ...coreOptions } = options;\n super({\n storage: createBrowserStorage(),\n lifecycle: createBrowserLifecycle(),\n platform: 'web',\n getContext: getBrowserContext,\n ...coreOptions,\n sessionStrategy: 'browser',\n });\n this.autoPageviews = autoPageviews ?? true;\n }\n\n async init(params?: ReactInitParams): Promise<InitSdkData> {\n const device = { ...getDefaultDeviceInfo(), ...params?.device };\n const autoTracking = getDefaultTrackingContext();\n const tracking = mergeTracking(autoTracking, params?.tracking);\n\n // enqueue the first pageview before the network round-trip so offline loads are kept\n this.startAutoPageviews();\n\n return super.init({\n timestamp: params?.timestamp,\n device,\n tracking,\n });\n }\n\n override async shutdown(): Promise<void> {\n this.stopNavigation?.();\n this.stopNavigation = null;\n await super.shutdown();\n }\n\n override async setConsent(state: ConsentState): Promise<void> {\n await super.setConsent(state);\n // pageviews are dropped (not queued) before consent: send the current page once it is granted\n if (state.analytics && this.landingPageDropped && this.stopNavigation) {\n this.landingPageDropped = false;\n void this.page();\n }\n }\n\n override async page(\n properties?: PageProperties,\n options?: Omit<TrackOptions, 'page'>,\n ): Promise<TrackEventData> {\n const pageContext = getPageContext();\n return super.page(\n {\n url: properties?.url ?? pageContext.url,\n referrer: properties?.referrer ?? pageContext.referrer,\n title: properties?.title ?? pageContext.title,\n },\n options,\n );\n }\n\n private startAutoPageviews(): void {\n if (!this.autoPageviews || this.stopNavigation) return;\n\n // on re-init (e.g. <Activity> hide→show) the same URL was already tracked\n const url = getPageContext().url;\n if (url === undefined || url !== this.lastAutoPageUrl) {\n this.lastAutoPageUrl = url;\n void this.page();\n void this.isTrackingAllowed().then((allowed) => {\n if (!allowed) this.landingPageDropped = true;\n });\n }\n this.stopNavigation = watchNavigation((url, previousUrl) => {\n this.lastAutoPageUrl = url;\n // after an SPA navigation the previous URL is the referrer\n void this.page({ referrer: previousUrl });\n });\n }\n}\n\nexport function getDefaultTrackingContext(): TrackingContext {\n if (typeof document === 'undefined') {\n return {};\n }\n\n return parseTrackingFromCookies({\n cookieHeader: document.cookie,\n url: typeof window !== 'undefined' ? window.location.href : undefined,\n });\n}\n","import { createContext, useContext, useEffect, useMemo, useRef, type ReactNode } from 'react';\nimport type { DeviceInfo, TrackingContext } from '@trichidata/core';\nimport { TrichiDataClient, type ReactClientOptions } from '../client';\n\nconst TrichiDataContext = createContext<TrichiDataClient | null>(null);\n\nexport interface TrichiDataProviderProps extends ReactClientOptions {\n children: ReactNode;\n autoInit?: boolean;\n device?: Partial<DeviceInfo>;\n tracking?: TrackingContext;\n}\n\nexport function TrichiDataProvider({\n children,\n autoInit = true,\n device,\n tracking,\n ...clientOptions\n}: TrichiDataProviderProps) {\n const { apiKey, autoPageviews, requireConsent, baseUrl } = clientOptions;\n const client = useMemo(\n () => new TrichiDataClient(clientOptions),\n [apiKey, autoPageviews, requireConsent, baseUrl],\n );\n\n const latest = useRef({ device, tracking });\n latest.current = { device, tracking };\n // guards against React StrictMode running the effect twice (and re-renders with new object props)\n const initializedClient = useRef<TrichiDataClient | null>(null);\n // dispose is deferred one tick so a StrictMode cleanup→setup cycle can cancel it\n const pendingDispose = useRef<{\n client: TrichiDataClient;\n timer: ReturnType<typeof setTimeout>;\n } | null>(null);\n // last client actually shut down (e.g. React 19.2 <Activity> hide); re-initialised on show\n const disposedClient = useRef<TrichiDataClient | null>(null);\n\n useEffect(() => {\n const pending = pendingDispose.current;\n if (pending?.client === client) {\n // StrictMode re-run (or autoInit toggle): keep the live client\n clearTimeout(pending.timer);\n pendingDispose.current = null;\n } else if (autoInit && disposedClient.current === client) {\n disposedClient.current = null;\n initializedClient.current = null;\n }\n\n if (autoInit && initializedClient.current !== client) {\n initializedClient.current = client;\n void client.init(latest.current).catch((error: unknown) => {\n clientOptions.onError?.(error);\n });\n }\n\n return () => {\n const timer = setTimeout(() => {\n if (pendingDispose.current?.client === client) pendingDispose.current = null;\n disposedClient.current = client;\n client.shutdown().catch((error: unknown) => {\n clientOptions.onError?.(error);\n });\n }, 0);\n pendingDispose.current = { client, timer };\n };\n }, [autoInit, client]);\n\n return <TrichiDataContext.Provider value={client}>{children}</TrichiDataContext.Provider>;\n}\n\nexport function useTrichiData(): TrichiDataClient {\n const client = useContext(TrichiDataContext);\n\n if (!client) {\n throw new Error('useTrichiData must be used within a TrichiDataProvider');\n }\n\n return client;\n}\n"]}
package/dist/index.d.cts CHANGED
@@ -1,27 +1,45 @@
1
1
  import * as react from 'react';
2
2
  import { ReactNode } from 'react';
3
- import { TrichiDataClientOptions, DeviceInfo, TrichiDataClient } from '@trichidata/core';
4
- export * from '@trichidata/core';
5
- export { API_PREFIX, DEFAULT_BASE_URL, HttpClient, SDK_VERSION, TrichiDataError as TrichiDataApiError, TrichiDataClient, TrichiDataError, createEventId, identify, initSdk, nowTimestamp, trackEvent, trackEventsBatch } from '@trichidata/core';
3
+ import { TrichiDataClientOptions, DeviceInfo, TrackingContext, TrichiDataClient as TrichiDataClient$1, InitSdkData, ConsentState, PageProperties, TrackOptions, TrackEventData } from '@trichidata/core';
4
+ export { AchievementUnlockedProperties, AdClickedProperties, AdImpressionProperties, AdType, CheckoutStartedProperties, ClientContext, ConsentState, DeviceInfo, IdentifyData, IdentifyRequest, InitSdkData, InitSdkParams, LeadSubmittedProperties, LevelAchievedProperties, LifecycleAdapter, LoggedInProperties, OrderCompletedProperties, OrderRefundedProperties, PageContext, PageProperties, PaymentInfoEnteredProperties, Platform, ProductAddedProperties, ProductItem, ProductRemovedProperties, ProductViewedProperties, SearchedProperties, SignedUpProperties, SpentCreditsProperties, StorageAdapter, Touch, TrackEventData, TrackOptions, TrackingContext, TrichiDataError as TrichiDataApiError, TrichiDataClientOptions, TrichiDataError, TutorialCompletedProperties } from '@trichidata/core';
6
5
 
7
- interface TrichiDataProviderProps extends Omit<TrichiDataClientOptions, 'sessionStrategy'> {
6
+ interface ReactInitParams {
7
+ timestamp?: number;
8
+ device?: Partial<DeviceInfo>;
9
+ tracking?: TrackingContext;
10
+ }
11
+ interface ReactClientOptions extends TrichiDataClientOptions {
12
+ /** Track a `page` event on init and on every SPA navigation (default: true) */
13
+ autoPageviews?: boolean;
14
+ }
15
+ declare class TrichiDataClient extends TrichiDataClient$1 {
16
+ private readonly autoPageviews;
17
+ private stopNavigation;
18
+ /** The initial pageview was dropped because consent was not granted yet. */
19
+ private landingPageDropped;
20
+ private lastAutoPageUrl;
21
+ constructor(options: ReactClientOptions);
22
+ init(params?: ReactInitParams): Promise<InitSdkData>;
23
+ shutdown(): Promise<void>;
24
+ setConsent(state: ConsentState): Promise<void>;
25
+ page(properties?: PageProperties, options?: Omit<TrackOptions, 'page'>): Promise<TrackEventData>;
26
+ private startAutoPageviews;
27
+ }
28
+ declare function getDefaultTrackingContext(): TrackingContext;
29
+
30
+ interface TrichiDataProviderProps extends ReactClientOptions {
8
31
  children: ReactNode;
9
32
  autoInit?: boolean;
10
33
  device?: Partial<DeviceInfo>;
34
+ tracking?: TrackingContext;
11
35
  }
12
- declare function TrichiDataProvider({ children, autoInit, apiKey, baseUrl, device, }: TrichiDataProviderProps): react.JSX.Element;
36
+ declare function TrichiDataProvider({ children, autoInit, device, tracking, ...clientOptions }: TrichiDataProviderProps): react.JSX.Element;
13
37
  declare function useTrichiData(): TrichiDataClient;
14
38
 
15
- declare function getDefaultDeviceInfo(): {
16
- ip: string;
17
- userAgent: string;
18
- locale: string;
19
- timezone: string;
20
- };
21
39
  declare function getPageContext(): {
22
40
  title?: string;
23
41
  url?: string;
24
42
  referrer?: string;
25
43
  };
26
44
 
27
- export { TrichiDataProvider, type TrichiDataProviderProps, getDefaultDeviceInfo, getPageContext, useTrichiData };
45
+ export { type ReactClientOptions, type ReactInitParams, TrichiDataClient, TrichiDataProvider, type TrichiDataProviderProps, getDefaultTrackingContext, getPageContext, useTrichiData };
package/dist/index.d.ts CHANGED
@@ -1,27 +1,45 @@
1
1
  import * as react from 'react';
2
2
  import { ReactNode } from 'react';
3
- import { TrichiDataClientOptions, DeviceInfo, TrichiDataClient } from '@trichidata/core';
4
- export * from '@trichidata/core';
5
- export { API_PREFIX, DEFAULT_BASE_URL, HttpClient, SDK_VERSION, TrichiDataError as TrichiDataApiError, TrichiDataClient, TrichiDataError, createEventId, identify, initSdk, nowTimestamp, trackEvent, trackEventsBatch } from '@trichidata/core';
3
+ import { TrichiDataClientOptions, DeviceInfo, TrackingContext, TrichiDataClient as TrichiDataClient$1, InitSdkData, ConsentState, PageProperties, TrackOptions, TrackEventData } from '@trichidata/core';
4
+ export { AchievementUnlockedProperties, AdClickedProperties, AdImpressionProperties, AdType, CheckoutStartedProperties, ClientContext, ConsentState, DeviceInfo, IdentifyData, IdentifyRequest, InitSdkData, InitSdkParams, LeadSubmittedProperties, LevelAchievedProperties, LifecycleAdapter, LoggedInProperties, OrderCompletedProperties, OrderRefundedProperties, PageContext, PageProperties, PaymentInfoEnteredProperties, Platform, ProductAddedProperties, ProductItem, ProductRemovedProperties, ProductViewedProperties, SearchedProperties, SignedUpProperties, SpentCreditsProperties, StorageAdapter, Touch, TrackEventData, TrackOptions, TrackingContext, TrichiDataError as TrichiDataApiError, TrichiDataClientOptions, TrichiDataError, TutorialCompletedProperties } from '@trichidata/core';
6
5
 
7
- interface TrichiDataProviderProps extends Omit<TrichiDataClientOptions, 'sessionStrategy'> {
6
+ interface ReactInitParams {
7
+ timestamp?: number;
8
+ device?: Partial<DeviceInfo>;
9
+ tracking?: TrackingContext;
10
+ }
11
+ interface ReactClientOptions extends TrichiDataClientOptions {
12
+ /** Track a `page` event on init and on every SPA navigation (default: true) */
13
+ autoPageviews?: boolean;
14
+ }
15
+ declare class TrichiDataClient extends TrichiDataClient$1 {
16
+ private readonly autoPageviews;
17
+ private stopNavigation;
18
+ /** The initial pageview was dropped because consent was not granted yet. */
19
+ private landingPageDropped;
20
+ private lastAutoPageUrl;
21
+ constructor(options: ReactClientOptions);
22
+ init(params?: ReactInitParams): Promise<InitSdkData>;
23
+ shutdown(): Promise<void>;
24
+ setConsent(state: ConsentState): Promise<void>;
25
+ page(properties?: PageProperties, options?: Omit<TrackOptions, 'page'>): Promise<TrackEventData>;
26
+ private startAutoPageviews;
27
+ }
28
+ declare function getDefaultTrackingContext(): TrackingContext;
29
+
30
+ interface TrichiDataProviderProps extends ReactClientOptions {
8
31
  children: ReactNode;
9
32
  autoInit?: boolean;
10
33
  device?: Partial<DeviceInfo>;
34
+ tracking?: TrackingContext;
11
35
  }
12
- declare function TrichiDataProvider({ children, autoInit, apiKey, baseUrl, device, }: TrichiDataProviderProps): react.JSX.Element;
36
+ declare function TrichiDataProvider({ children, autoInit, device, tracking, ...clientOptions }: TrichiDataProviderProps): react.JSX.Element;
13
37
  declare function useTrichiData(): TrichiDataClient;
14
38
 
15
- declare function getDefaultDeviceInfo(): {
16
- ip: string;
17
- userAgent: string;
18
- locale: string;
19
- timezone: string;
20
- };
21
39
  declare function getPageContext(): {
22
40
  title?: string;
23
41
  url?: string;
24
42
  referrer?: string;
25
43
  };
26
44
 
27
- export { TrichiDataProvider, type TrichiDataProviderProps, getDefaultDeviceInfo, getPageContext, useTrichiData };
45
+ export { type ReactClientOptions, type ReactInitParams, TrichiDataClient, TrichiDataProvider, type TrichiDataProviderProps, getDefaultTrackingContext, getPageContext, useTrichiData };
package/dist/index.js CHANGED
@@ -1,14 +1,11 @@
1
- import { createContext, useMemo, useEffect, useContext } from 'react';
2
- import { TrichiDataClient, SDK_VERSION } from '@trichidata/core';
3
- export { API_PREFIX, DEFAULT_BASE_URL, HttpClient, SDK_VERSION, TrichiDataError as TrichiDataApiError, TrichiDataClient, TrichiDataError, createEventId, identify, initSdk, nowTimestamp, trackEvent, trackEventsBatch } from '@trichidata/core';
1
+ import { createContext, useMemo, useRef, useEffect, useContext } from 'react';
2
+ import { TrichiDataClient as TrichiDataClient$1, mergeTracking, parseTrackingFromCookies, MemoryStorage } from '@trichidata/core';
3
+ export { TrichiDataError as TrichiDataApiError, TrichiDataError } from '@trichidata/core';
4
4
  import { jsx } from 'react/jsx-runtime';
5
5
 
6
6
  // src/react/TrichiDataProvider.tsx
7
-
8
- // src/utils.ts
9
7
  function getDefaultDeviceInfo() {
10
8
  return {
11
- ip: "0.0.0.0",
12
9
  userAgent: typeof navigator !== "undefined" ? navigator.userAgent : "unknown",
13
10
  locale: typeof navigator !== "undefined" ? navigator.language : "en-US",
14
11
  timezone: typeof Intl !== "undefined" ? Intl.DateTimeFormat().resolvedOptions().timeZone : "UTC"
@@ -24,27 +21,255 @@ function getPageContext() {
24
21
  referrer: document.referrer || void 0
25
22
  };
26
23
  }
24
+ function getBrowserContext() {
25
+ if (typeof document === "undefined" || typeof window === "undefined") {
26
+ return {};
27
+ }
28
+ return {
29
+ screen: window.location.pathname,
30
+ url: window.location.href,
31
+ title: document.title,
32
+ referrer: document.referrer || void 0
33
+ };
34
+ }
35
+ function createBrowserStorage() {
36
+ const memory = new MemoryStorage();
37
+ let probed;
38
+ const local = () => {
39
+ try {
40
+ return typeof localStorage === "undefined" ? null : localStorage;
41
+ } catch {
42
+ return null;
43
+ }
44
+ };
45
+ const probe = () => {
46
+ try {
47
+ const storage = local();
48
+ if (!storage) return false;
49
+ storage.setItem("td_probe", "1");
50
+ storage.removeItem("td_probe");
51
+ return true;
52
+ } catch {
53
+ return false;
54
+ }
55
+ };
56
+ return {
57
+ get persistent() {
58
+ if (probed === void 0) probed = probe();
59
+ return probed;
60
+ },
61
+ getItem(key) {
62
+ try {
63
+ const value = local()?.getItem(key);
64
+ if (value !== void 0 && value !== null) return value;
65
+ } catch {
66
+ }
67
+ return memory.getItem(key);
68
+ },
69
+ setItem(key, value) {
70
+ try {
71
+ const storage = local();
72
+ if (storage) {
73
+ storage.setItem(key, value);
74
+ return;
75
+ }
76
+ } catch {
77
+ try {
78
+ local()?.removeItem(key);
79
+ } catch {
80
+ }
81
+ }
82
+ memory.setItem(key, value);
83
+ },
84
+ removeItem(key) {
85
+ try {
86
+ local()?.removeItem(key);
87
+ } catch {
88
+ }
89
+ memory.removeItem(key);
90
+ }
91
+ };
92
+ }
93
+ function createBrowserLifecycle() {
94
+ return {
95
+ onBackground(callback) {
96
+ if (typeof document === "undefined" || typeof window === "undefined") {
97
+ return () => void 0;
98
+ }
99
+ const onVisibility = () => {
100
+ if (document.visibilityState === "hidden") callback();
101
+ };
102
+ window.addEventListener("pagehide", callback);
103
+ document.addEventListener("visibilitychange", onVisibility);
104
+ return () => {
105
+ window.removeEventListener("pagehide", callback);
106
+ document.removeEventListener("visibilitychange", onVisibility);
107
+ };
108
+ }
109
+ };
110
+ }
111
+ function watchNavigation(onNavigate) {
112
+ if (typeof window === "undefined" || typeof history === "undefined") {
113
+ return () => void 0;
114
+ }
115
+ let lastUrl = window.location.href;
116
+ let timer = null;
117
+ const check = () => {
118
+ if (timer !== null) clearTimeout(timer);
119
+ timer = setTimeout(() => {
120
+ timer = null;
121
+ const url = window.location.href;
122
+ if (url === lastUrl) return;
123
+ const previous = lastUrl;
124
+ lastUrl = url;
125
+ onNavigate(url, previous);
126
+ }, 0);
127
+ };
128
+ const originalPush = history.pushState;
129
+ const originalReplace = history.replaceState;
130
+ const push = function(...args) {
131
+ const result = originalPush.apply(this, args);
132
+ check();
133
+ return result;
134
+ };
135
+ const replace = function(...args) {
136
+ const result = originalReplace.apply(this, args);
137
+ check();
138
+ return result;
139
+ };
140
+ history.pushState = push;
141
+ history.replaceState = replace;
142
+ window.addEventListener("popstate", check);
143
+ return () => {
144
+ if (timer !== null) clearTimeout(timer);
145
+ if (history.pushState === push) history.pushState = originalPush;
146
+ if (history.replaceState === replace) history.replaceState = originalReplace;
147
+ window.removeEventListener("popstate", check);
148
+ };
149
+ }
150
+
151
+ // src/client.ts
152
+ var TrichiDataClient = class extends TrichiDataClient$1 {
153
+ autoPageviews;
154
+ stopNavigation = null;
155
+ /** The initial pageview was dropped because consent was not granted yet. */
156
+ landingPageDropped = false;
157
+ lastAutoPageUrl;
158
+ constructor(options) {
159
+ const { autoPageviews, ...coreOptions } = options;
160
+ super({
161
+ storage: createBrowserStorage(),
162
+ lifecycle: createBrowserLifecycle(),
163
+ platform: "web",
164
+ getContext: getBrowserContext,
165
+ ...coreOptions,
166
+ sessionStrategy: "browser"
167
+ });
168
+ this.autoPageviews = autoPageviews ?? true;
169
+ }
170
+ async init(params) {
171
+ const device = { ...getDefaultDeviceInfo(), ...params?.device };
172
+ const autoTracking = getDefaultTrackingContext();
173
+ const tracking = mergeTracking(autoTracking, params?.tracking);
174
+ this.startAutoPageviews();
175
+ return super.init({
176
+ timestamp: params?.timestamp,
177
+ device,
178
+ tracking
179
+ });
180
+ }
181
+ async shutdown() {
182
+ this.stopNavigation?.();
183
+ this.stopNavigation = null;
184
+ await super.shutdown();
185
+ }
186
+ async setConsent(state) {
187
+ await super.setConsent(state);
188
+ if (state.analytics && this.landingPageDropped && this.stopNavigation) {
189
+ this.landingPageDropped = false;
190
+ void this.page();
191
+ }
192
+ }
193
+ async page(properties, options) {
194
+ const pageContext = getPageContext();
195
+ return super.page(
196
+ {
197
+ url: properties?.url ?? pageContext.url,
198
+ referrer: properties?.referrer ?? pageContext.referrer,
199
+ title: properties?.title ?? pageContext.title
200
+ },
201
+ options
202
+ );
203
+ }
204
+ startAutoPageviews() {
205
+ if (!this.autoPageviews || this.stopNavigation) return;
206
+ const url = getPageContext().url;
207
+ if (url === void 0 || url !== this.lastAutoPageUrl) {
208
+ this.lastAutoPageUrl = url;
209
+ void this.page();
210
+ void this.isTrackingAllowed().then((allowed) => {
211
+ if (!allowed) this.landingPageDropped = true;
212
+ });
213
+ }
214
+ this.stopNavigation = watchNavigation((url2, previousUrl) => {
215
+ this.lastAutoPageUrl = url2;
216
+ void this.page({ referrer: previousUrl });
217
+ });
218
+ }
219
+ };
220
+ function getDefaultTrackingContext() {
221
+ if (typeof document === "undefined") {
222
+ return {};
223
+ }
224
+ return parseTrackingFromCookies({
225
+ cookieHeader: document.cookie,
226
+ url: typeof window !== "undefined" ? window.location.href : void 0
227
+ });
228
+ }
27
229
  var TrichiDataContext = createContext(null);
28
230
  function TrichiDataProvider({
29
231
  children,
30
232
  autoInit = true,
31
- apiKey,
32
- baseUrl,
33
- device
233
+ device,
234
+ tracking,
235
+ ...clientOptions
34
236
  }) {
237
+ const { apiKey, autoPageviews, requireConsent, baseUrl } = clientOptions;
35
238
  const client = useMemo(
36
- () => new TrichiDataClient({ apiKey, baseUrl, sessionStrategy: "browser" }),
37
- [apiKey, baseUrl]
239
+ () => new TrichiDataClient(clientOptions),
240
+ [apiKey, autoPageviews, requireConsent, baseUrl]
38
241
  );
242
+ const latest = useRef({ device, tracking });
243
+ latest.current = { device, tracking };
244
+ const initializedClient = useRef(null);
245
+ const pendingDispose = useRef(null);
246
+ const disposedClient = useRef(null);
39
247
  useEffect(() => {
40
- if (autoInit) {
41
- void client.init({
42
- timestamp: Date.now(),
43
- device: { ...getDefaultDeviceInfo(), ...device },
44
- sdkVersion: SDK_VERSION
248
+ const pending = pendingDispose.current;
249
+ if (pending?.client === client) {
250
+ clearTimeout(pending.timer);
251
+ pendingDispose.current = null;
252
+ } else if (autoInit && disposedClient.current === client) {
253
+ disposedClient.current = null;
254
+ initializedClient.current = null;
255
+ }
256
+ if (autoInit && initializedClient.current !== client) {
257
+ initializedClient.current = client;
258
+ void client.init(latest.current).catch((error) => {
259
+ clientOptions.onError?.(error);
45
260
  });
46
261
  }
47
- }, [autoInit, client, device]);
262
+ return () => {
263
+ const timer = setTimeout(() => {
264
+ if (pendingDispose.current?.client === client) pendingDispose.current = null;
265
+ disposedClient.current = client;
266
+ client.shutdown().catch((error) => {
267
+ clientOptions.onError?.(error);
268
+ });
269
+ }, 0);
270
+ pendingDispose.current = { client, timer };
271
+ };
272
+ }, [autoInit, client]);
48
273
  return /* @__PURE__ */ jsx(TrichiDataContext.Provider, { value: client, children });
49
274
  }
50
275
  function useTrichiData() {
@@ -55,6 +280,6 @@ function useTrichiData() {
55
280
  return client;
56
281
  }
57
282
 
58
- export { TrichiDataProvider, getDefaultDeviceInfo, getPageContext, useTrichiData };
283
+ export { TrichiDataClient, TrichiDataProvider, getDefaultTrackingContext, getPageContext, useTrichiData };
59
284
  //# sourceMappingURL=index.js.map
60
285
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/utils.ts","../src/react/TrichiDataProvider.tsx"],"names":[],"mappings":";;;;;;;;AAAO,SAAS,oBAAA,GAKd;AACA,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,SAAA;AAAA,IACJ,SAAA,EAAW,OAAO,SAAA,KAAc,WAAA,GAAc,UAAU,SAAA,GAAY,SAAA;AAAA,IACpE,MAAA,EAAQ,OAAO,SAAA,KAAc,WAAA,GAAc,UAAU,QAAA,GAAW,OAAA;AAAA,IAChE,QAAA,EACE,OAAO,IAAA,KAAS,WAAA,GAAc,KAAK,cAAA,EAAe,CAAE,eAAA,EAAgB,CAAE,QAAA,GAAW;AAAA,GACrF;AACF;AAEO,SAAS,cAAA,GAId;AACA,EAAA,IAAI,OAAO,QAAA,KAAa,WAAA,IAAe,OAAO,WAAW,WAAA,EAAa;AACpE,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,OAAO;AAAA,IACL,OAAO,QAAA,CAAS,KAAA;AAAA,IAChB,GAAA,EAAK,OAAO,QAAA,CAAS,IAAA;AAAA,IACrB,QAAA,EAAU,SAAS,QAAA,IAAY;AAAA,GACjC;AACF;ACpBA,IAAM,iBAAA,GAAoB,cAAuC,IAAI,CAAA;AAQ9D,SAAS,kBAAA,CAAmB;AAAA,EACjC,QAAA;AAAA,EACA,QAAA,GAAW,IAAA;AAAA,EACX,MAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF,CAAA,EAA4B;AAC1B,EAAA,MAAM,MAAA,GAAS,OAAA;AAAA,IACb,MAAM,IAAI,gBAAA,CAAiB,EAAE,QAAQ,OAAA,EAAS,eAAA,EAAiB,WAAW,CAAA;AAAA,IAC1E,CAAC,QAAQ,OAAO;AAAA,GAClB;AAEA,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,KAAK,OAAO,IAAA,CAAK;AAAA,QACf,SAAA,EAAW,KAAK,GAAA,EAAI;AAAA,QACpB,QAAQ,EAAE,GAAG,oBAAA,EAAqB,EAAG,GAAG,MAAA,EAAO;AAAA,QAC/C,UAAA,EAAY;AAAA,OACb,CAAA;AAAA,IACH;AAAA,EACF,CAAA,EAAG,CAAC,QAAA,EAAU,MAAA,EAAQ,MAAM,CAAC,CAAA;AAE7B,EAAA,2BAAQ,iBAAA,CAAkB,QAAA,EAAlB,EAA2B,KAAA,EAAO,QAAS,QAAA,EAAS,CAAA;AAC9D;AAEO,SAAS,aAAA,GAAkC;AAChD,EAAA,MAAM,MAAA,GAAS,WAAW,iBAAiB,CAAA;AAE3C,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,MAAM,wDAAwD,CAAA;AAAA,EAC1E;AAEA,EAAA,OAAO,MAAA;AACT","file":"index.js","sourcesContent":["export function getDefaultDeviceInfo(): {\n ip: string;\n userAgent: string;\n locale: string;\n timezone: string;\n} {\n return {\n ip: '0.0.0.0',\n userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : 'unknown',\n locale: typeof navigator !== 'undefined' ? navigator.language : 'en-US',\n timezone:\n typeof Intl !== 'undefined' ? Intl.DateTimeFormat().resolvedOptions().timeZone : 'UTC',\n };\n}\n\nexport function getPageContext(): {\n title?: string;\n url?: string;\n referrer?: string;\n} {\n if (typeof document === 'undefined' || typeof window === 'undefined') {\n return {};\n }\n\n return {\n title: document.title,\n url: window.location.href,\n referrer: document.referrer || undefined,\n };\n}\n","import { createContext, useContext, useEffect, useMemo, type ReactNode } from 'react';\nimport {\n SDK_VERSION,\n TrichiDataClient,\n type DeviceInfo,\n type TrichiDataClientOptions,\n} from '@trichidata/core';\nimport { getDefaultDeviceInfo } from '../utils';\n\nconst TrichiDataContext = createContext<TrichiDataClient | null>(null);\n\nexport interface TrichiDataProviderProps extends Omit<TrichiDataClientOptions, 'sessionStrategy'> {\n children: ReactNode;\n autoInit?: boolean;\n device?: Partial<DeviceInfo>;\n}\n\nexport function TrichiDataProvider({\n children,\n autoInit = true,\n apiKey,\n baseUrl,\n device,\n}: TrichiDataProviderProps) {\n const client = useMemo(\n () => new TrichiDataClient({ apiKey, baseUrl, sessionStrategy: 'browser' }),\n [apiKey, baseUrl],\n );\n\n useEffect(() => {\n if (autoInit) {\n void client.init({\n timestamp: Date.now(),\n device: { ...getDefaultDeviceInfo(), ...device },\n sdkVersion: SDK_VERSION,\n });\n }\n }, [autoInit, client, device]);\n\n return <TrichiDataContext.Provider value={client}>{children}</TrichiDataContext.Provider>;\n}\n\nexport function useTrichiData(): TrichiDataClient {\n const client = useContext(TrichiDataContext);\n\n if (!client) {\n throw new Error('useTrichiData must be used within a TrichiDataProvider');\n }\n\n return client;\n}\n"]}
1
+ {"version":3,"sources":["../src/utils.ts","../src/client.ts","../src/react/TrichiDataProvider.tsx"],"names":["CoreClient","url"],"mappings":"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","file":"index.js","sourcesContent":["import { MemoryStorage, type ClientContext, type StorageAdapter } from '@trichidata/core';\n\nexport function getDefaultDeviceInfo(): {\n userAgent: string;\n locale: string;\n timezone: string;\n} {\n return {\n userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : 'unknown',\n locale: typeof navigator !== 'undefined' ? navigator.language : 'en-US',\n timezone:\n typeof Intl !== 'undefined' ? Intl.DateTimeFormat().resolvedOptions().timeZone : 'UTC',\n };\n}\n\nexport function getPageContext(): {\n title?: string;\n url?: string;\n referrer?: string;\n} {\n if (typeof document === 'undefined' || typeof window === 'undefined') {\n return {};\n }\n\n return {\n title: document.title,\n url: window.location.href,\n referrer: document.referrer || undefined,\n };\n}\n\n/** Context read by the core client: screen = pathname, url/referrer feed attribution. */\nexport function getBrowserContext(): ClientContext {\n if (typeof document === 'undefined' || typeof window === 'undefined') {\n return {};\n }\n\n return {\n screen: window.location.pathname,\n url: window.location.href,\n title: document.title,\n referrer: document.referrer || undefined,\n };\n}\n\n/**\n * localStorage-backed storage; falls back to memory when unavailable (private mode, SSR).\n * `persistent` is true only if a probe write to localStorage succeeds (old Safari private\n * mode and a full quota throw on setItem, so data would silently live in memory).\n */\nexport function createBrowserStorage(): StorageAdapter & { readonly persistent: boolean } {\n const memory = new MemoryStorage();\n let probed: boolean | undefined;\n\n const local = (): Storage | null => {\n try {\n return typeof localStorage === 'undefined' ? null : localStorage;\n } catch {\n return null;\n }\n };\n\n const probe = (): boolean => {\n try {\n const storage = local();\n if (!storage) return false;\n storage.setItem('td_probe', '1');\n storage.removeItem('td_probe');\n return true;\n } catch {\n return false;\n }\n };\n\n return {\n get persistent() {\n if (probed === undefined) probed = probe();\n return probed;\n },\n getItem(key) {\n try {\n // getItem returns null for a missing key: then use the memory copy (written when setItem threw).\n const value = local()?.getItem(key);\n if (value !== undefined && value !== null) return value;\n } catch {\n // fall through to memory\n }\n return memory.getItem(key);\n },\n setItem(key, value) {\n try {\n const storage = local();\n if (storage) {\n storage.setItem(key, value);\n return;\n }\n } catch {\n // an older value left in localStorage would be read instead of the memory copy\n try {\n local()?.removeItem(key);\n } catch {\n // ignore\n }\n }\n memory.setItem(key, value);\n },\n removeItem(key) {\n try {\n local()?.removeItem(key);\n } catch {\n // ignore\n }\n memory.removeItem(key);\n },\n };\n}\n\n/** Flush when the page is hidden or being unloaded. */\nexport function createBrowserLifecycle(): {\n onBackground(callback: () => void): () => void;\n} {\n return {\n onBackground(callback) {\n if (typeof document === 'undefined' || typeof window === 'undefined') {\n return () => undefined;\n }\n\n const onVisibility = () => {\n if (document.visibilityState === 'hidden') callback();\n };\n\n window.addEventListener('pagehide', callback);\n document.addEventListener('visibilitychange', onVisibility);\n\n return () => {\n window.removeEventListener('pagehide', callback);\n document.removeEventListener('visibilitychange', onVisibility);\n };\n },\n };\n}\n\n/**\n * Track SPA navigations (history.pushState / replaceState / popstate).\n * `onNavigate(url, previousUrl)` fires once per distinct URL. Returns a stop function.\n */\nexport function watchNavigation(\n onNavigate: (url: string, previousUrl: string) => void,\n): () => void {\n if (typeof window === 'undefined' || typeof history === 'undefined') {\n return () => undefined;\n }\n\n let lastUrl = window.location.href;\n let timer: ReturnType<typeof setTimeout> | null = null;\n\n const check = () => {\n // let the app update document.title before we read it\n if (timer !== null) clearTimeout(timer);\n timer = setTimeout(() => {\n timer = null;\n const url = window.location.href;\n if (url === lastUrl) return;\n const previous = lastUrl;\n lastUrl = url;\n onNavigate(url, previous);\n }, 0);\n };\n\n const originalPush = history.pushState;\n const originalReplace = history.replaceState;\n\n const push: History['pushState'] = function (this: History, ...args) {\n const result = originalPush.apply(this, args);\n check();\n return result;\n };\n const replace: History['replaceState'] = function (this: History, ...args) {\n const result = originalReplace.apply(this, args);\n check();\n return result;\n };\n\n history.pushState = push;\n history.replaceState = replace;\n window.addEventListener('popstate', check);\n\n return () => {\n if (timer !== null) clearTimeout(timer);\n if (history.pushState === push) history.pushState = originalPush;\n if (history.replaceState === replace) history.replaceState = originalReplace;\n window.removeEventListener('popstate', check);\n };\n}\n","import {\n TrichiDataClient as CoreClient,\n mergeTracking,\n parseTrackingFromCookies,\n type ConsentState,\n type DeviceInfo,\n type InitSdkData,\n type PageProperties,\n type TrackEventData,\n type TrackingContext,\n type TrackOptions,\n type TrichiDataClientOptions,\n} from '@trichidata/core';\nimport {\n createBrowserLifecycle,\n createBrowserStorage,\n getBrowserContext,\n getDefaultDeviceInfo,\n getPageContext,\n watchNavigation,\n} from './utils';\n\nexport interface ReactInitParams {\n timestamp?: number;\n device?: Partial<DeviceInfo>;\n tracking?: TrackingContext;\n}\n\nexport interface ReactClientOptions extends TrichiDataClientOptions {\n /** Track a `page` event on init and on every SPA navigation (default: true) */\n autoPageviews?: boolean;\n}\n\nexport class TrichiDataClient extends CoreClient {\n private readonly autoPageviews: boolean;\n private stopNavigation: (() => void) | null = null;\n /** The initial pageview was dropped because consent was not granted yet. */\n private landingPageDropped = false;\n private lastAutoPageUrl: string | undefined;\n\n constructor(options: ReactClientOptions) {\n const { autoPageviews, ...coreOptions } = options;\n super({\n storage: createBrowserStorage(),\n lifecycle: createBrowserLifecycle(),\n platform: 'web',\n getContext: getBrowserContext,\n ...coreOptions,\n sessionStrategy: 'browser',\n });\n this.autoPageviews = autoPageviews ?? true;\n }\n\n async init(params?: ReactInitParams): Promise<InitSdkData> {\n const device = { ...getDefaultDeviceInfo(), ...params?.device };\n const autoTracking = getDefaultTrackingContext();\n const tracking = mergeTracking(autoTracking, params?.tracking);\n\n // enqueue the first pageview before the network round-trip so offline loads are kept\n this.startAutoPageviews();\n\n return super.init({\n timestamp: params?.timestamp,\n device,\n tracking,\n });\n }\n\n override async shutdown(): Promise<void> {\n this.stopNavigation?.();\n this.stopNavigation = null;\n await super.shutdown();\n }\n\n override async setConsent(state: ConsentState): Promise<void> {\n await super.setConsent(state);\n // pageviews are dropped (not queued) before consent: send the current page once it is granted\n if (state.analytics && this.landingPageDropped && this.stopNavigation) {\n this.landingPageDropped = false;\n void this.page();\n }\n }\n\n override async page(\n properties?: PageProperties,\n options?: Omit<TrackOptions, 'page'>,\n ): Promise<TrackEventData> {\n const pageContext = getPageContext();\n return super.page(\n {\n url: properties?.url ?? pageContext.url,\n referrer: properties?.referrer ?? pageContext.referrer,\n title: properties?.title ?? pageContext.title,\n },\n options,\n );\n }\n\n private startAutoPageviews(): void {\n if (!this.autoPageviews || this.stopNavigation) return;\n\n // on re-init (e.g. <Activity> hide→show) the same URL was already tracked\n const url = getPageContext().url;\n if (url === undefined || url !== this.lastAutoPageUrl) {\n this.lastAutoPageUrl = url;\n void this.page();\n void this.isTrackingAllowed().then((allowed) => {\n if (!allowed) this.landingPageDropped = true;\n });\n }\n this.stopNavigation = watchNavigation((url, previousUrl) => {\n this.lastAutoPageUrl = url;\n // after an SPA navigation the previous URL is the referrer\n void this.page({ referrer: previousUrl });\n });\n }\n}\n\nexport function getDefaultTrackingContext(): TrackingContext {\n if (typeof document === 'undefined') {\n return {};\n }\n\n return parseTrackingFromCookies({\n cookieHeader: document.cookie,\n url: typeof window !== 'undefined' ? window.location.href : undefined,\n });\n}\n","import { createContext, useContext, useEffect, useMemo, useRef, type ReactNode } from 'react';\nimport type { DeviceInfo, TrackingContext } from '@trichidata/core';\nimport { TrichiDataClient, type ReactClientOptions } from '../client';\n\nconst TrichiDataContext = createContext<TrichiDataClient | null>(null);\n\nexport interface TrichiDataProviderProps extends ReactClientOptions {\n children: ReactNode;\n autoInit?: boolean;\n device?: Partial<DeviceInfo>;\n tracking?: TrackingContext;\n}\n\nexport function TrichiDataProvider({\n children,\n autoInit = true,\n device,\n tracking,\n ...clientOptions\n}: TrichiDataProviderProps) {\n const { apiKey, autoPageviews, requireConsent, baseUrl } = clientOptions;\n const client = useMemo(\n () => new TrichiDataClient(clientOptions),\n [apiKey, autoPageviews, requireConsent, baseUrl],\n );\n\n const latest = useRef({ device, tracking });\n latest.current = { device, tracking };\n // guards against React StrictMode running the effect twice (and re-renders with new object props)\n const initializedClient = useRef<TrichiDataClient | null>(null);\n // dispose is deferred one tick so a StrictMode cleanup→setup cycle can cancel it\n const pendingDispose = useRef<{\n client: TrichiDataClient;\n timer: ReturnType<typeof setTimeout>;\n } | null>(null);\n // last client actually shut down (e.g. React 19.2 <Activity> hide); re-initialised on show\n const disposedClient = useRef<TrichiDataClient | null>(null);\n\n useEffect(() => {\n const pending = pendingDispose.current;\n if (pending?.client === client) {\n // StrictMode re-run (or autoInit toggle): keep the live client\n clearTimeout(pending.timer);\n pendingDispose.current = null;\n } else if (autoInit && disposedClient.current === client) {\n disposedClient.current = null;\n initializedClient.current = null;\n }\n\n if (autoInit && initializedClient.current !== client) {\n initializedClient.current = client;\n void client.init(latest.current).catch((error: unknown) => {\n clientOptions.onError?.(error);\n });\n }\n\n return () => {\n const timer = setTimeout(() => {\n if (pendingDispose.current?.client === client) pendingDispose.current = null;\n disposedClient.current = client;\n client.shutdown().catch((error: unknown) => {\n clientOptions.onError?.(error);\n });\n }, 0);\n pendingDispose.current = { client, timer };\n };\n }, [autoInit, client]);\n\n return <TrichiDataContext.Provider value={client}>{children}</TrichiDataContext.Provider>;\n}\n\nexport function useTrichiData(): TrichiDataClient {\n const client = useContext(TrichiDataContext);\n\n if (!client) {\n throw new Error('useTrichiData must be used within a TrichiDataProvider');\n }\n\n return client;\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@trichidata/react",
3
- "version": "0.4.3",
3
+ "version": "0.6.0",
4
4
  "description": "TrichiData analytics SDK for React",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",
@@ -8,10 +8,16 @@
8
8
  "types": "./dist/index.d.ts",
9
9
  "exports": {
10
10
  ".": {
11
- "types": "./dist/index.d.ts",
12
- "import": "./dist/index.js",
13
- "require": "./dist/index.cjs"
14
- }
11
+ "import": {
12
+ "types": "./dist/index.d.ts",
13
+ "default": "./dist/index.js"
14
+ },
15
+ "require": {
16
+ "types": "./dist/index.d.cts",
17
+ "default": "./dist/index.cjs"
18
+ }
19
+ },
20
+ "./package.json": "./package.json"
15
21
  },
16
22
  "files": [
17
23
  "dist"
@@ -23,13 +29,15 @@
23
29
  "lint:fix": "eslint src --fix",
24
30
  "format": "prettier --write \"src/**/*.{ts,tsx}\"",
25
31
  "format:check": "prettier --check \"src/**/*.{ts,tsx}\"",
26
- "typecheck": "tsc --noEmit"
32
+ "typecheck": "tsc --noEmit",
33
+ "check:package": "publint --strict",
34
+ "check": "npm run lint && npm run typecheck && npm run format:check && npm run build && npm run check:package"
27
35
  },
28
36
  "peerDependencies": {
29
37
  "react": ">=18.0.0"
30
38
  },
31
39
  "dependencies": {
32
- "@trichidata/core": "^0.4.0"
40
+ "@trichidata/core": "^0.6.0"
33
41
  },
34
42
  "devDependencies": {
35
43
  "@eslint/js": "^9.28.0",
@@ -37,6 +45,7 @@
37
45
  "eslint": "^9.28.0",
38
46
  "eslint-config-prettier": "^10.1.5",
39
47
  "prettier": "^3.5.3",
48
+ "publint": "^0.3.12",
40
49
  "react": "^19.1.0",
41
50
  "tsup": "^8.5.0",
42
51
  "typescript": "^5.8.3",