@shware/analytics 3.6.4 → 3.7.0

package/README.md

@@ -7,7 +7,6 @@ layout.tsx
 ```tsx
 import { setupAnalytics } from '@shware/analytics';
 import { getTags, getDeviceId, storage } from '@shware/analytics/web';
-import { v4 as uuidv4 } from 'uuid';
 
 setupAnalytics({
   storage,
@@ -42,7 +41,54 @@ function Button() {
 
 ## UTM params
 
-- utm_source
+Typed as `UTMParams` (exported from `@shware/analytics`). Value unions follow the
+[GA4 default channel group definitions](https://support.google.com/analytics/answer/9756891).
+
+| Param                | Meaning                                                            | Examples                       |
+| -------------------- | ------------------------------------------------------------------ | ------------------------------ |
+| utm_source           | Traffic source (platform/site)                                     | `google`, `meta`, `newsletter` |
+| utm_medium           | Marketing medium, **the key input for GA4 channel classification** | `cpc`, `paid_social`, `email`  |
+| utm_campaign         | Campaign name                                                      | `summer_promo_2026`            |
+| utm_id               | Campaign ID                                                        | `abc123`                       |
+| utm_term             | Paid keyword                                                       | `virtual+staging`              |
+| utm_content          | Differentiates creatives pointing to the same URL                  | `banner_a` / `banner_b`        |
+| utm_source_platform  | Platform managing the buy                                          | `Google Ads`, `Manual`         |
+| utm_creative_format  | Creative type                                                      | `display`, `video`             |
+| utm_marketing_tactic | Targeting tactic                                                   | `remarketing`, `prospecting`   |
+
+### Why Google Ads uses `medium=cpc`
+
+GA4 assigns traffic to default channel groups by matching source/medium against
+regex rules. All paid channels require the medium to match:
+
+```
+^(.*cp.*|ppc|retargeting|paid.*)$
+```
+
+`cpc` (cost-per-click) is the standard medium Google Ads applies with
+auto-tagging (gclid), so manual tagging keeps the same value:
+`source=google` + `medium=cpc` → search site list + paid regex → **Paid Search**.
+An arbitrary medium like `ads` or `google` matches no rule and the traffic
+falls into **Unassigned/Referral**, breaking channel reports.
+
+### Recommended combinations
+
+| Placement           | utm_source               | utm_medium    | GA4 channel    |
+| ------------------- | ------------------------ | ------------- | -------------- |
+| Google Ads search   | `google`                 | `cpc`         | Paid Search    |
+| Meta paid ads       | `meta`                   | `paid_social` | Paid Social    |
+| FB/IG organic posts | `facebook` / `instagram` | `social`      | Organic Social |
+| Email marketing     | `newsletter`             | `email`       | Email          |
+| Affiliate           | partner name             | `affiliate`   | Affiliates     |
+| SMS                 | `sms`                    | `sms`         | SMS            |
+
+### Gotchas
+
+- Lowercase everything, no spaces (use `_` or `-`): `Google` and `google` are
+  two different sources in reports.
+- With Google Ads auto-tagging (gclid) enabled, manual UTMs are unnecessary;
+  when both are present the manual UTM wins for display — keep the values
+  consistent (`google`/`cpc`) to avoid splitting data.
 
 ## GAD params
 
@@ -59,10 +105,11 @@ function Button() {
 We strongly recommend using the Reddit Pixel and Conversions API (CAPI) together.
 
 - rdt_cid: from url params
-- \_rdt_uuid: from first-party cookie
+- \_rdt_uuid: from a first-party cookie
 
 ### LinkedIn
 
 If we receive an Insight Tag event and a Conversions API event from the same account with the same eventId, we discard the Conversions API event and count only the Insight Tag event in campaign reporting.
+``
 
 - [Click IDs](https://learn.microsoft.com/en-us/linkedin/marketing/conversions/enabling-first-party-cookies?view=li-lms-2025-10&source=recommendations): get li_fat_id from url params and cookie

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1,23 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+exports.__toESM = __toESM;

package/dist/constants/storage.cjs

@@ -1,40 +1,15 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/constants/storage.ts
+const keys = {
+	device_id: "device_id",
+	visitor_id: "visitor_id",
+	first_open_time: "first_open_time",
+	first_visit_time: "first_visit_time",
+	fbc: "fbc",
+	fbclid: "fbclid",
+	rdt_cid: "rdt_cid"
 };
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+//#endregion
+exports.keys = keys;
 
-// src/constants/storage.ts
-var storage_exports = {};
-__export(storage_exports, {
-  keys: () => keys
-});
-module.exports = __toCommonJS(storage_exports);
-var keys = {
-  device_id: "device_id",
-  visitor_id: "visitor_id",
-  first_open_time: "first_open_time",
-  first_visit_time: "first_visit_time",
-  // click ids
-  fbc: "fbc",
-  fbclid: "fbclid",
-  rdt_cid: "rdt_cid"
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  keys
-});
 //# sourceMappingURL=storage.cjs.map

package/dist/constants/storage.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/constants/storage.ts"],"sourcesContent":["export const keys = {\n  device_id: 'device_id',\n  visitor_id: 'visitor_id',\n  first_open_time: 'first_open_time',\n  first_visit_time: 'first_visit_time',\n  // click ids\n  fbc: 'fbc',\n  fbclid: 'fbclid',\n  rdt_cid: 'rdt_cid',\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,IAAM,OAAO;AAAA,EAClB,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,iBAAiB;AAAA,EACjB,kBAAkB;AAAA;AAAA,EAElB,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,SAAS;AACX;","names":[]}
+{"version":3,"file":"storage.cjs","names":[],"sources":["../../src/constants/storage.ts"],"sourcesContent":["export const keys = {\n  device_id: 'device_id',\n  visitor_id: 'visitor_id',\n  first_open_time: 'first_open_time',\n  first_visit_time: 'first_visit_time',\n  // click ids\n  fbc: 'fbc',\n  fbclid: 'fbclid',\n  rdt_cid: 'rdt_cid',\n} as const;\n"],"mappings":";;AAAA,MAAa,OAAO;CAClB,WAAW;CACX,YAAY;CACZ,iBAAiB;CACjB,kBAAkB;CAElB,KAAK;CACL,QAAQ;CACR,SAAS;AACX"}

package/dist/constants/storage.d.cts

@@ -1,11 +1,13 @@
+//#region src/constants/storage.d.ts
 declare const keys: {
-    readonly device_id: "device_id";
-    readonly visitor_id: "visitor_id";
-    readonly first_open_time: "first_open_time";
-    readonly first_visit_time: "first_visit_time";
-    readonly fbc: "fbc";
-    readonly fbclid: "fbclid";
-    readonly rdt_cid: "rdt_cid";
+  readonly device_id: 'device_id';
+  readonly visitor_id: 'visitor_id';
+  readonly first_open_time: 'first_open_time';
+  readonly first_visit_time: 'first_visit_time';
+  readonly fbc: 'fbc';
+  readonly fbclid: 'fbclid';
+  readonly rdt_cid: 'rdt_cid';
 };
-
+//#endregion
 export { keys };
+//# sourceMappingURL=storage.d.cts.map

package/dist/constants/storage.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.cts","names":[],"sources":["../../src/constants/storage.ts"],"mappings":";cAAa;WACX;WACA;WACA;WACA;WAEA;WACA;WACA"}

package/dist/constants/storage.d.mts

@@ -0,0 +1,13 @@
+//#region src/constants/storage.d.ts
+declare const keys: {
+  readonly device_id: 'device_id';
+  readonly visitor_id: 'visitor_id';
+  readonly first_open_time: 'first_open_time';
+  readonly first_visit_time: 'first_visit_time';
+  readonly fbc: 'fbc';
+  readonly fbclid: 'fbclid';
+  readonly rdt_cid: 'rdt_cid';
+};
+//#endregion
+export { keys };
+//# sourceMappingURL=storage.d.mts.map

package/dist/constants/storage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.mts","names":[],"sources":["../../src/constants/storage.ts"],"mappings":";cAAa;WACX;WACA;WACA;WACA;WAEA;WACA;WACA"}

package/dist/constants/storage.mjs

@@ -1,15 +1,14 @@
-// src/constants/storage.ts
-var keys = {
-  device_id: "device_id",
-  visitor_id: "visitor_id",
-  first_open_time: "first_open_time",
-  first_visit_time: "first_visit_time",
-  // click ids
-  fbc: "fbc",
-  fbclid: "fbclid",
-  rdt_cid: "rdt_cid"
-};
-export {
-  keys
+//#region src/constants/storage.ts
+const keys = {
+	device_id: "device_id",
+	visitor_id: "visitor_id",
+	first_open_time: "first_open_time",
+	first_visit_time: "first_visit_time",
+	fbc: "fbc",
+	fbclid: "fbclid",
+	rdt_cid: "rdt_cid"
 };
+//#endregion
+export { keys };
+
 //# sourceMappingURL=storage.mjs.map

package/dist/constants/storage.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/constants/storage.ts"],"sourcesContent":["export const keys = {\n  device_id: 'device_id',\n  visitor_id: 'visitor_id',\n  first_open_time: 'first_open_time',\n  first_visit_time: 'first_visit_time',\n  // click ids\n  fbc: 'fbc',\n  fbclid: 'fbclid',\n  rdt_cid: 'rdt_cid',\n} as const;\n"],"mappings":";AAAO,IAAM,OAAO;AAAA,EAClB,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,iBAAiB;AAAA,EACjB,kBAAkB;AAAA;AAAA,EAElB,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,SAAS;AACX;","names":[]}
+{"version":3,"file":"storage.mjs","names":[],"sources":["../../src/constants/storage.ts"],"sourcesContent":["export const keys = {\n  device_id: 'device_id',\n  visitor_id: 'visitor_id',\n  first_open_time: 'first_open_time',\n  first_visit_time: 'first_visit_time',\n  // click ids\n  fbc: 'fbc',\n  fbclid: 'fbclid',\n  rdt_cid: 'rdt_cid',\n} as const;\n"],"mappings":";AAAA,MAAa,OAAO;CAClB,WAAW;CACX,YAAY;CACZ,iBAAiB;CACjB,kBAAkB;CAElB,KAAK;CACL,QAAQ;CACR,SAAS;AACX"}

package/dist/feedback/index.cjs

@@ -1,43 +1,17 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/feedback/index.ts
-var feedback_exports = {};
-__export(feedback_exports, {
-  sendFeedback: () => sendFeedback
-});
-module.exports = __toCommonJS(feedback_exports);
-var import_utils = require("@shware/utils");
-var import_setup = require("../setup/index.cjs");
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_setup_index = require("../setup/index.cjs");
+let _shware_utils = require("@shware/utils");
+//#region src/feedback/index.ts
 async function sendFeedback(dto) {
-  const response = await (0, import_utils.fetch)(`${import_setup.config.endpoint}/feedback`, {
-    method: "POST",
-    credentials: "include",
-    headers: await import_setup.config.getHeaders(),
-    body: JSON.stringify(dto)
-  });
-  if (!response.ok) {
-    throw new Error(`Failed to send feedback: ${response.status} ${await response.text()}`);
-  }
+	const response = await (0, _shware_utils.fetch)(`${require_setup_index.config.endpoint}/feedback`, {
+		method: "POST",
+		credentials: "include",
+		headers: await require_setup_index.config.getHeaders(),
+		body: JSON.stringify(dto)
+	});
+	if (!response.ok) throw new Error(`Failed to send feedback: ${response.status} ${await response.text()}`);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  sendFeedback
-});
+//#endregion
+exports.sendFeedback = sendFeedback;
+
 //# sourceMappingURL=index.cjs.map

package/dist/feedback/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feedback/index.ts"],"sourcesContent":["import { fetch } from '@shware/utils';\nimport type { CreateFeedbackDTO } from '../schema/index';\nimport { config } from '../setup/index';\n\nexport async function sendFeedback(dto: CreateFeedbackDTO) {\n  const response = await fetch(`${config.endpoint}/feedback`, {\n    method: 'POST',\n    credentials: 'include',\n    headers: await config.getHeaders(),\n    body: JSON.stringify(dto),\n  });\n\n  if (!response.ok) {\n    throw new Error(`Failed to send feedback: ${response.status} ${await response.text()}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAsB;AAEtB,mBAAuB;AAEvB,eAAsB,aAAa,KAAwB;AACzD,QAAM,WAAW,UAAM,oBAAM,GAAG,oBAAO,QAAQ,aAAa;AAAA,IAC1D,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,SAAS,MAAM,oBAAO,WAAW;AAAA,IACjC,MAAM,KAAK,UAAU,GAAG;AAAA,EAC1B,CAAC;AAED,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,4BAA4B,SAAS,MAAM,IAAI,MAAM,SAAS,KAAK,CAAC,EAAE;AAAA,EACxF;AACF;","names":[]}
+{"version":3,"file":"index.cjs","names":["config"],"sources":["../../src/feedback/index.ts"],"sourcesContent":["import { fetch } from '@shware/utils';\nimport type { CreateFeedbackDTO } from '../schema/index';\nimport { config } from '../setup/index';\n\nexport async function sendFeedback(dto: CreateFeedbackDTO) {\n  const response = await fetch(`${config.endpoint}/feedback`, {\n    method: 'POST',\n    credentials: 'include',\n    headers: await config.getHeaders(),\n    body: JSON.stringify(dto),\n  });\n\n  if (!response.ok) {\n    throw new Error(`Failed to send feedback: ${response.status} ${await response.text()}`);\n  }\n}\n"],"mappings":";;;;AAIA,eAAsB,aAAa,KAAwB;CACzD,MAAM,WAAW,OAAA,GAAA,cAAA,MAAA,CAAY,GAAGA,oBAAAA,OAAO,SAAS,YAAY;EAC1D,QAAQ;EACR,aAAa;EACb,SAAS,MAAMA,oBAAAA,OAAO,WAAW;EACjC,MAAM,KAAK,UAAU,GAAG;CAC1B,CAAC;CAED,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,MAAM,4BAA4B,SAAS,OAAO,GAAG,MAAM,SAAS,KAAK,GAAG;AAE1F"}

package/dist/feedback/index.d.cts

@@ -1,6 +1,6 @@
-import { CreateFeedbackDTO } from '../schema/index.cjs';
-import 'zod/mini';
-
+import { CreateFeedbackDTO } from "../schema/index.cjs";
+//#region src/feedback/index.d.ts
 declare function sendFeedback(dto: CreateFeedbackDTO): Promise<void>;
-
+//#endregion
 export { sendFeedback };
+//# sourceMappingURL=index.d.cts.map

package/dist/feedback/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/feedback/index.ts"],"mappings":";;iBAIsB,aAAa,KAAK,oBAAiB"}

package/dist/feedback/index.d.mts

@@ -0,0 +1,6 @@
+import { CreateFeedbackDTO } from "../schema/index.mjs";
+//#region src/feedback/index.d.ts
+declare function sendFeedback(dto: CreateFeedbackDTO): Promise<void>;
+//#endregion
+export { sendFeedback };
+//# sourceMappingURL=index.d.mts.map

package/dist/feedback/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/feedback/index.ts"],"mappings":";;iBAIsB,aAAa,KAAK,oBAAiB"}

package/dist/feedback/index.mjs

@@ -1,18 +1,16 @@
-// src/feedback/index.ts
-import { fetch } from "@shware/utils";
 import { config } from "../setup/index.mjs";
+import { fetch } from "@shware/utils";
+//#region src/feedback/index.ts
 async function sendFeedback(dto) {
-  const response = await fetch(`${config.endpoint}/feedback`, {
-    method: "POST",
-    credentials: "include",
-    headers: await config.getHeaders(),
-    body: JSON.stringify(dto)
-  });
-  if (!response.ok) {
-    throw new Error(`Failed to send feedback: ${response.status} ${await response.text()}`);
-  }
+	const response = await fetch(`${config.endpoint}/feedback`, {
+		method: "POST",
+		credentials: "include",
+		headers: await config.getHeaders(),
+		body: JSON.stringify(dto)
+	});
+	if (!response.ok) throw new Error(`Failed to send feedback: ${response.status} ${await response.text()}`);
 }
-export {
-  sendFeedback
-};
+//#endregion
+export { sendFeedback };
+
 //# sourceMappingURL=index.mjs.map

package/dist/feedback/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feedback/index.ts"],"sourcesContent":["import { fetch } from '@shware/utils';\nimport type { CreateFeedbackDTO } from '../schema/index';\nimport { config } from '../setup/index';\n\nexport async function sendFeedback(dto: CreateFeedbackDTO) {\n  const response = await fetch(`${config.endpoint}/feedback`, {\n    method: 'POST',\n    credentials: 'include',\n    headers: await config.getHeaders(),\n    body: JSON.stringify(dto),\n  });\n\n  if (!response.ok) {\n    throw new Error(`Failed to send feedback: ${response.status} ${await response.text()}`);\n  }\n}\n"],"mappings":";AAAA,SAAS,aAAa;AAEtB,SAAS,cAAc;AAEvB,eAAsB,aAAa,KAAwB;AACzD,QAAM,WAAW,MAAM,MAAM,GAAG,OAAO,QAAQ,aAAa;AAAA,IAC1D,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,SAAS,MAAM,OAAO,WAAW;AAAA,IACjC,MAAM,KAAK,UAAU,GAAG;AAAA,EAC1B,CAAC;AAED,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,4BAA4B,SAAS,MAAM,IAAI,MAAM,SAAS,KAAK,CAAC,EAAE;AAAA,EACxF;AACF;","names":[]}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/feedback/index.ts"],"sourcesContent":["import { fetch } from '@shware/utils';\nimport type { CreateFeedbackDTO } from '../schema/index';\nimport { config } from '../setup/index';\n\nexport async function sendFeedback(dto: CreateFeedbackDTO) {\n  const response = await fetch(`${config.endpoint}/feedback`, {\n    method: 'POST',\n    credentials: 'include',\n    headers: await config.getHeaders(),\n    body: JSON.stringify(dto),\n  });\n\n  if (!response.ok) {\n    throw new Error(`Failed to send feedback: ${response.status} ${await response.text()}`);\n  }\n}\n"],"mappings":";;;AAIA,eAAsB,aAAa,KAAwB;CACzD,MAAM,WAAW,MAAM,MAAM,GAAG,OAAO,SAAS,YAAY;EAC1D,QAAQ;EACR,aAAa;EACb,SAAS,MAAM,OAAO,WAAW;EACjC,MAAM,KAAK,UAAU,GAAG;CAC1B,CAAC;CAED,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,MAAM,4BAA4B,SAAS,OAAO,GAAG,MAAM,SAAS,KAAK,GAAG;AAE1F"}

package/dist/hooks/use-app-analytics.cjs

@@ -1,72 +1,53 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/hooks/use-app-analytics.ts
-var use_app_analytics_exports = {};
-__export(use_app_analytics_exports, {
-  useAppAnalytics: () => useAppAnalytics
-});
-module.exports = __toCommonJS(use_app_analytics_exports);
-var import_react = require("react");
-var import_react_native = require("react-native");
-var import_storage = require("../constants/storage.cjs");
-var import_setup = require("../setup/index.cjs");
-var import_session = require("../setup/session.cjs");
-var import_track = require("../track/index.cjs");
-var import_use_previous = require("./use-previous.cjs");
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_setup_index = require("../setup/index.cjs");
+const require_setup_session = require("../setup/session.cjs");
+const require_constants_storage = require("../constants/storage.cjs");
+const require_track_index = require("../track/index.cjs");
+const require_hooks_use_previous = require("./use-previous.cjs");
+let react = require("react");
+let react_native = require("react-native");
+//#region src/hooks/use-app-analytics.ts
 function sendFirstOpen(pathname) {
-  if (import_setup.config.storage.getItem(import_storage.keys.first_open_time)) return;
-  (0, import_track.track)("first_open", { screen_name: pathname, screen_class: pathname });
-  import_setup.config.storage.setItem(import_storage.keys.first_open_time, (/* @__PURE__ */ new Date()).toISOString());
+	if (require_setup_index.config.storage.getItem(require_constants_storage.keys.first_open_time)) return;
+	require_track_index.track("first_open", {
+		screen_name: pathname,
+		screen_class: pathname
+	});
+	require_setup_index.config.storage.setItem(require_constants_storage.keys.first_open_time, (/* @__PURE__ */ new Date()).toISOString());
 }
 function sendUserEngagement() {
-  const engagement_time_msec = import_session.session.flush();
-  if (engagement_time_msec <= 0) return;
-  (0, import_track.track)("user_engagement", { engagement_time_msec, trigger: "background" });
+	const engagement_time_msec = require_setup_session.session.flush();
+	if (engagement_time_msec <= 0) return;
+	require_track_index.track("user_engagement", {
+		engagement_time_msec,
+		trigger: "background"
+	});
 }
 function useAppAnalytics(pathname) {
-  const prevPathname = (0, import_use_previous.usePrevious)(pathname);
-  (0, import_react.useEffect)(() => {
-    sendFirstOpen(pathname);
-    (0, import_track.track)("session_start", void 0);
-    const subscription = import_react_native.AppState.addEventListener("change", (state) => {
-      import_session.session.updateAccumulator();
-      if (state === "active" && !import_session.session.isActive()) {
-        import_session.session.updateActive(true);
-      } else if (state !== "active" && import_session.session.isActive()) {
-        import_session.session.updateActive(false);
-        sendUserEngagement();
-      }
-    });
-    return () => subscription.remove();
-  }, []);
-  (0, import_react.useEffect)(() => {
-    (0, import_track.track)("screen_view", {
-      screen_name: pathname,
-      screen_class: pathname,
-      previous_screen_class: prevPathname ?? void 0,
-      engagement_time_msec: prevPathname ? import_session.session.flush() : void 0
-    });
-  }, [pathname]);
+	const prevPathname = require_hooks_use_previous.usePrevious(pathname);
+	(0, react.useEffect)(() => {
+		sendFirstOpen(pathname);
+		require_track_index.track("session_start", void 0);
+		const subscription = react_native.AppState.addEventListener("change", (state) => {
+			require_setup_session.session.updateAccumulator();
+			if (state === "active" && !require_setup_session.session.isActive()) require_setup_session.session.updateActive(true);
+			else if (state !== "active" && require_setup_session.session.isActive()) {
+				require_setup_session.session.updateActive(false);
+				sendUserEngagement();
+			}
+		});
+		return () => subscription.remove();
+	}, []);
+	(0, react.useEffect)(() => {
+		require_track_index.track("screen_view", {
+			screen_name: pathname,
+			screen_class: pathname,
+			previous_screen_class: prevPathname ?? void 0,
+			engagement_time_msec: prevPathname ? require_setup_session.session.flush() : void 0
+		});
+	}, [pathname]);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  useAppAnalytics
-});
+//#endregion
+exports.useAppAnalytics = useAppAnalytics;
+
 //# sourceMappingURL=use-app-analytics.cjs.map

package/dist/hooks/use-app-analytics.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/use-app-analytics.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport { AppState } from 'react-native';\nimport { keys } from '../constants/storage';\nimport { config } from '../setup/index';\nimport { session } from '../setup/session';\nimport { track } from '../track/index';\nimport { usePrevious } from './use-previous';\n\nfunction sendFirstOpen(pathname: string) {\n  if (config.storage.getItem(keys.first_open_time)) return;\n  track('first_open', { screen_name: pathname, screen_class: pathname });\n  config.storage.setItem(keys.first_open_time, new Date().toISOString());\n}\n\nfunction sendUserEngagement() {\n  const engagement_time_msec = session.flush();\n  if (engagement_time_msec <= 0) return;\n  track('user_engagement', { engagement_time_msec, trigger: 'background' });\n}\n\nexport function useAppAnalytics(pathname: string) {\n  const prevPathname = usePrevious(pathname);\n\n  useEffect(() => {\n    sendFirstOpen(pathname);\n    track('session_start', undefined);\n\n    const subscription = AppState.addEventListener('change', (state) => {\n      session.updateAccumulator();\n      // when returning to the foreground from the background\n      if (state === 'active' && !session.isActive()) {\n        session.updateActive(true);\n      }\n      // when entering the background\n      else if (state !== 'active' && session.isActive()) {\n        session.updateActive(false);\n        sendUserEngagement();\n      }\n    });\n\n    return () => subscription.remove();\n  }, []);\n\n  // when the screen is switched, the engagement time of the previous screen is recorded\n  useEffect(() => {\n    track('screen_view', {\n      screen_name: pathname,\n      screen_class: pathname,\n      previous_screen_class: prevPathname ?? undefined,\n      engagement_time_msec: prevPathname ? session.flush() : undefined,\n    });\n  }, [pathname]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA0B;AAC1B,0BAAyB;AACzB,qBAAqB;AACrB,mBAAuB;AACvB,qBAAwB;AACxB,mBAAsB;AACtB,0BAA4B;AAE5B,SAAS,cAAc,UAAkB;AACvC,MAAI,oBAAO,QAAQ,QAAQ,oBAAK,eAAe,EAAG;AAClD,0BAAM,cAAc,EAAE,aAAa,UAAU,cAAc,SAAS,CAAC;AACrE,sBAAO,QAAQ,QAAQ,oBAAK,kBAAiB,oBAAI,KAAK,GAAE,YAAY,CAAC;AACvE;AAEA,SAAS,qBAAqB;AAC5B,QAAM,uBAAuB,uBAAQ,MAAM;AAC3C,MAAI,wBAAwB,EAAG;AAC/B,0BAAM,mBAAmB,EAAE,sBAAsB,SAAS,aAAa,CAAC;AAC1E;AAEO,SAAS,gBAAgB,UAAkB;AAChD,QAAM,mBAAe,iCAAY,QAAQ;AAEzC,8BAAU,MAAM;AACd,kBAAc,QAAQ;AACtB,4BAAM,iBAAiB,MAAS;AAEhC,UAAM,eAAe,6BAAS,iBAAiB,UAAU,CAAC,UAAU;AAClE,6BAAQ,kBAAkB;AAE1B,UAAI,UAAU,YAAY,CAAC,uBAAQ,SAAS,GAAG;AAC7C,+BAAQ,aAAa,IAAI;AAAA,MAC3B,WAES,UAAU,YAAY,uBAAQ,SAAS,GAAG;AACjD,+BAAQ,aAAa,KAAK;AAC1B,2BAAmB;AAAA,MACrB;AAAA,IACF,CAAC;AAED,WAAO,MAAM,aAAa,OAAO;AAAA,EACnC,GAAG,CAAC,CAAC;AAGL,8BAAU,MAAM;AACd,4BAAM,eAAe;AAAA,MACnB,aAAa;AAAA,MACb,cAAc;AAAA,MACd,uBAAuB,gBAAgB;AAAA,MACvC,sBAAsB,eAAe,uBAAQ,MAAM,IAAI;AAAA,IACzD,CAAC;AAAA,EACH,GAAG,CAAC,QAAQ,CAAC;AACf;","names":[]}
+{"version":3,"file":"use-app-analytics.cjs","names":["config","keys","session","usePrevious","AppState"],"sources":["../../src/hooks/use-app-analytics.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport { AppState } from 'react-native';\nimport { keys } from '../constants/storage';\nimport { config } from '../setup/index';\nimport { session } from '../setup/session';\nimport { track } from '../track/index';\nimport { usePrevious } from './use-previous';\n\nfunction sendFirstOpen(pathname: string) {\n  if (config.storage.getItem(keys.first_open_time)) return;\n  track('first_open', { screen_name: pathname, screen_class: pathname });\n  config.storage.setItem(keys.first_open_time, new Date().toISOString());\n}\n\nfunction sendUserEngagement() {\n  const engagement_time_msec = session.flush();\n  if (engagement_time_msec <= 0) return;\n  track('user_engagement', { engagement_time_msec, trigger: 'background' });\n}\n\nexport function useAppAnalytics(pathname: string) {\n  const prevPathname = usePrevious(pathname);\n\n  useEffect(() => {\n    sendFirstOpen(pathname);\n    track('session_start', undefined);\n\n    const subscription = AppState.addEventListener('change', (state) => {\n      session.updateAccumulator();\n      // when returning to the foreground from the background\n      if (state === 'active' && !session.isActive()) {\n        session.updateActive(true);\n      }\n      // when entering the background\n      else if (state !== 'active' && session.isActive()) {\n        session.updateActive(false);\n        sendUserEngagement();\n      }\n    });\n\n    return () => subscription.remove();\n  }, []);\n\n  // when the screen is switched, the engagement time of the previous screen is recorded\n  useEffect(() => {\n    track('screen_view', {\n      screen_name: pathname,\n      screen_class: pathname,\n      previous_screen_class: prevPathname ?? undefined,\n      engagement_time_msec: prevPathname ? session.flush() : undefined,\n    });\n  }, [pathname]);\n}\n"],"mappings":";;;;;;;;;AAQA,SAAS,cAAc,UAAkB;CACvC,IAAIA,oBAAAA,OAAO,QAAQ,QAAQC,0BAAAA,KAAK,eAAe,GAAG;CAClD,oBAAA,MAAM,cAAc;EAAE,aAAa;EAAU,cAAc;CAAS,CAAC;CACrE,oBAAA,OAAO,QAAQ,QAAQA,0BAAAA,KAAK,kCAAiB,IAAI,KAAK,EAAA,CAAE,YAAY,CAAC;AACvE;AAEA,SAAS,qBAAqB;CAC5B,MAAM,uBAAuBC,sBAAAA,QAAQ,MAAM;CAC3C,IAAI,wBAAwB,GAAG;CAC/B,oBAAA,MAAM,mBAAmB;EAAE;EAAsB,SAAS;CAAa,CAAC;AAC1E;AAEA,SAAgB,gBAAgB,UAAkB;CAChD,MAAM,eAAeC,2BAAAA,YAAY,QAAQ;CAEzC,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,cAAc,QAAQ;EACtB,oBAAA,MAAM,iBAAiB,KAAA,CAAS;EAEhC,MAAM,eAAeC,aAAAA,SAAS,iBAAiB,WAAW,UAAU;GAClE,sBAAA,QAAQ,kBAAkB;GAE1B,IAAI,UAAU,YAAY,CAACF,sBAAAA,QAAQ,SAAS,GAC1C,sBAAA,QAAQ,aAAa,IAAI;QAGtB,IAAI,UAAU,YAAYA,sBAAAA,QAAQ,SAAS,GAAG;IACjD,sBAAA,QAAQ,aAAa,KAAK;IAC1B,mBAAmB;GACrB;EACF,CAAC;EAED,aAAa,aAAa,OAAO;CACnC,GAAG,CAAC,CAAC;CAGL,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,oBAAA,MAAM,eAAe;GACnB,aAAa;GACb,cAAc;GACd,uBAAuB,gBAAgB,KAAA;GACvC,sBAAsB,eAAeA,sBAAAA,QAAQ,MAAM,IAAI,KAAA;EACzD,CAAC;CACH,GAAG,CAAC,QAAQ,CAAC;AACf"}

package/dist/hooks/use-app-analytics.d.cts

@@ -1,3 +1,5 @@
+//#region src/hooks/use-app-analytics.d.ts
 declare function useAppAnalytics(pathname: string): void;
-
+//#endregion
 export { useAppAnalytics };
+//# sourceMappingURL=use-app-analytics.d.cts.map

package/dist/hooks/use-app-analytics.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-app-analytics.d.cts","names":[],"sources":["../../src/hooks/use-app-analytics.ts"],"mappings":";iBAoBgB,gBAAgB"}

package/dist/hooks/use-app-analytics.d.mts

@@ -0,0 +1,5 @@
+//#region src/hooks/use-app-analytics.d.ts
+declare function useAppAnalytics(pathname: string): void;
+//#endregion
+export { useAppAnalytics };
+//# sourceMappingURL=use-app-analytics.d.mts.map

package/dist/hooks/use-app-analytics.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-app-analytics.d.mts","names":[],"sources":["../../src/hooks/use-app-analytics.ts"],"mappings":";iBAoBgB,gBAAgB"}

package/dist/hooks/use-app-analytics.mjs

@@ -1,47 +1,52 @@
-// src/hooks/use-app-analytics.ts
-import { useEffect } from "react";
-import { AppState } from "react-native";
-import { keys } from "../constants/storage.mjs";
 import { config } from "../setup/index.mjs";
 import { session } from "../setup/session.mjs";
+import { keys } from "../constants/storage.mjs";
 import { track } from "../track/index.mjs";
 import { usePrevious } from "./use-previous.mjs";
+import { useEffect } from "react";
+import { AppState } from "react-native";
+//#region src/hooks/use-app-analytics.ts
 function sendFirstOpen(pathname) {
-  if (config.storage.getItem(keys.first_open_time)) return;
-  track("first_open", { screen_name: pathname, screen_class: pathname });
-  config.storage.setItem(keys.first_open_time, (/* @__PURE__ */ new Date()).toISOString());
+	if (config.storage.getItem(keys.first_open_time)) return;
+	track("first_open", {
+		screen_name: pathname,
+		screen_class: pathname
+	});
+	config.storage.setItem(keys.first_open_time, (/* @__PURE__ */ new Date()).toISOString());
 }
 function sendUserEngagement() {
-  const engagement_time_msec = session.flush();
-  if (engagement_time_msec <= 0) return;
-  track("user_engagement", { engagement_time_msec, trigger: "background" });
+	const engagement_time_msec = session.flush();
+	if (engagement_time_msec <= 0) return;
+	track("user_engagement", {
+		engagement_time_msec,
+		trigger: "background"
+	});
 }
 function useAppAnalytics(pathname) {
-  const prevPathname = usePrevious(pathname);
-  useEffect(() => {
-    sendFirstOpen(pathname);
-    track("session_start", void 0);
-    const subscription = AppState.addEventListener("change", (state) => {
-      session.updateAccumulator();
-      if (state === "active" && !session.isActive()) {
-        session.updateActive(true);
-      } else if (state !== "active" && session.isActive()) {
-        session.updateActive(false);
-        sendUserEngagement();
-      }
-    });
-    return () => subscription.remove();
-  }, []);
-  useEffect(() => {
-    track("screen_view", {
-      screen_name: pathname,
-      screen_class: pathname,
-      previous_screen_class: prevPathname ?? void 0,
-      engagement_time_msec: prevPathname ? session.flush() : void 0
-    });
-  }, [pathname]);
+	const prevPathname = usePrevious(pathname);
+	useEffect(() => {
+		sendFirstOpen(pathname);
+		track("session_start", void 0);
+		const subscription = AppState.addEventListener("change", (state) => {
+			session.updateAccumulator();
+			if (state === "active" && !session.isActive()) session.updateActive(true);
+			else if (state !== "active" && session.isActive()) {
+				session.updateActive(false);
+				sendUserEngagement();
+			}
+		});
+		return () => subscription.remove();
+	}, []);
+	useEffect(() => {
+		track("screen_view", {
+			screen_name: pathname,
+			screen_class: pathname,
+			previous_screen_class: prevPathname ?? void 0,
+			engagement_time_msec: prevPathname ? session.flush() : void 0
+		});
+	}, [pathname]);
 }
-export {
-  useAppAnalytics
-};
+//#endregion
+export { useAppAnalytics };
+
 //# sourceMappingURL=use-app-analytics.mjs.map