@qurvo/sdk-browser 0.0.13 → 0.0.15

package/dist/utm.d.ts

@@ -0,0 +1,15 @@
+/** Standard UTM parameter names that the SDK auto-captures from the page URL. */
+declare const UTM_PARAMS: readonly ["utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
+export type UtmKey = (typeof UTM_PARAMS)[number];
+/**
+ * Parse UTM parameters from a URL search string.
+ * Returns only non-empty UTM values. Returns an empty object if none are present.
+ */
+export declare function parseUtmParams(search: string): Partial<Record<UtmKey, string>>;
+/**
+ * Get current UTM parameters from `window.location.search`.
+ * Safe to call in non-browser environments (returns empty object).
+ */
+export declare function getUtmParams(): Partial<Record<UtmKey, string>>;
+export {};
+//# sourceMappingURL=utm.d.ts.map

package/dist/utm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utm.d.ts","sourceRoot":"","sources":["../src/utm.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,QAAA,MAAM,UAAU,kFAMN,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkB9E;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAG9D"}

package/dist/utm.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseUtmParams = parseUtmParams;
+exports.getUtmParams = getUtmParams;
+/** Standard UTM parameter names that the SDK auto-captures from the page URL. */
+const UTM_PARAMS = [
+    'utm_source',
+    'utm_medium',
+    'utm_campaign',
+    'utm_term',
+    'utm_content',
+];
+/**
+ * Parse UTM parameters from a URL search string.
+ * Returns only non-empty UTM values. Returns an empty object if none are present.
+ */
+function parseUtmParams(search) {
+    if (!search)
+        return {};
+    let params;
+    try {
+        params = new URLSearchParams(search);
+    }
+    catch {
+        return {};
+    }
+    const result = {};
+    for (const key of UTM_PARAMS) {
+        const value = params.get(key);
+        if (value) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Get current UTM parameters from `window.location.search`.
+ * Safe to call in non-browser environments (returns empty object).
+ */
+function getUtmParams() {
+    if (typeof window === 'undefined')
+        return {};
+    return parseUtmParams(window.location.search);
+}
+//# sourceMappingURL=utm.js.map

package/dist/utm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utm.js","sourceRoot":"","sources":["../src/utm.ts"],"names":[],"mappings":";;AAeA,wCAkBC;AAMD,oCAGC;AA1CD,iFAAiF;AACjF,MAAM,UAAU,GAAG;IACjB,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,UAAU;IACV,aAAa;CACL,CAAC;AAIX;;;GAGG;AACH,SAAgB,cAAc,CAAC,MAAc;IAC3C,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvB,IAAI,MAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAoC,EAAE,CAAC;IACnD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY;IAC1B,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,EAAE,CAAC;IAC7C,OAAO,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC"}

package/dist/utm.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=utm.test.d.ts.map

package/dist/utm.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utm.test.d.ts","sourceRoot":"","sources":["../src/utm.test.ts"],"names":[],"mappings":""}

package/dist/utm.test.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const utm_1 = require("./utm");
+(0, vitest_1.describe)('parseUtmParams', () => {
+    (0, vitest_1.it)('extracts all 5 UTM parameters', () => {
+        const search = '?utm_source=google&utm_medium=cpc&utm_campaign=spring&utm_term=shoes&utm_content=banner';
+        (0, vitest_1.expect)((0, utm_1.parseUtmParams)(search)).toEqual({
+            utm_source: 'google',
+            utm_medium: 'cpc',
+            utm_campaign: 'spring',
+            utm_term: 'shoes',
+            utm_content: 'banner',
+        });
+    });
+    (0, vitest_1.it)('returns only present UTM parameters', () => {
+        (0, vitest_1.expect)((0, utm_1.parseUtmParams)('?utm_source=google&utm_medium=email')).toEqual({
+            utm_source: 'google',
+            utm_medium: 'email',
+        });
+    });
+    (0, vitest_1.it)('returns empty object when no UTM params present', () => {
+        (0, vitest_1.expect)((0, utm_1.parseUtmParams)('?page=1&sort=asc')).toEqual({});
+    });
+    (0, vitest_1.it)('returns empty object for empty search string', () => {
+        (0, vitest_1.expect)((0, utm_1.parseUtmParams)('')).toEqual({});
+    });
+    (0, vitest_1.it)('returns empty object for search string with only ?', () => {
+        (0, vitest_1.expect)((0, utm_1.parseUtmParams)('?')).toEqual({});
+    });
+    (0, vitest_1.it)('ignores empty UTM values', () => {
+        (0, vitest_1.expect)((0, utm_1.parseUtmParams)('?utm_source=&utm_medium=email')).toEqual({
+            utm_medium: 'email',
+        });
+    });
+    (0, vitest_1.it)('decodes URL-encoded UTM values', () => {
+        (0, vitest_1.expect)((0, utm_1.parseUtmParams)('?utm_source=google%20ads&utm_campaign=spring%2Fsale')).toEqual({
+            utm_source: 'google ads',
+            utm_campaign: 'spring/sale',
+        });
+    });
+    (0, vitest_1.it)('ignores non-UTM parameters', () => {
+        (0, vitest_1.expect)((0, utm_1.parseUtmParams)('?utm_source=google&ref=abc&fbclid=xyz')).toEqual({
+            utm_source: 'google',
+        });
+    });
+    (0, vitest_1.it)('handles UTM params mixed with hash fragments (search only)', () => {
+        // URLSearchParams only gets the search part, not the hash
+        (0, vitest_1.expect)((0, utm_1.parseUtmParams)('?utm_source=twitter')).toEqual({
+            utm_source: 'twitter',
+        });
+    });
+    (0, vitest_1.it)('is case-sensitive (only lowercase utm_ keys)', () => {
+        (0, vitest_1.expect)((0, utm_1.parseUtmParams)('?UTM_SOURCE=google&utm_source=bing')).toEqual({
+            utm_source: 'bing',
+        });
+    });
+});
+//# sourceMappingURL=utm.test.js.map

package/dist/utm.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utm.test.js","sourceRoot":"","sources":["../src/utm.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,+BAAuC;AAEvC,IAAA,iBAAQ,EAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAA,WAAE,EAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GACV,yFAAyF,CAAC;QAC5F,IAAA,eAAM,EAAC,IAAA,oBAAc,EAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YACrC,UAAU,EAAE,QAAQ;YACpB,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,QAAQ;YACtB,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,QAAQ;SACtB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,IAAA,eAAM,EAAC,IAAA,oBAAc,EAAC,qCAAqC,CAAC,CAAC,CAAC,OAAO,CAAC;YACpE,UAAU,EAAE,QAAQ;YACpB,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,IAAA,eAAM,EAAC,IAAA,oBAAc,EAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,IAAA,eAAM,EAAC,IAAA,oBAAc,EAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,IAAA,eAAM,EAAC,IAAA,oBAAc,EAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,IAAA,eAAM,EAAC,IAAA,oBAAc,EAAC,+BAA+B,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9D,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,IAAA,eAAM,EAAC,IAAA,oBAAc,EAAC,qDAAqD,CAAC,CAAC,CAAC,OAAO,CAAC;YACpF,UAAU,EAAE,YAAY;YACxB,YAAY,EAAE,aAAa;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,IAAA,eAAM,EAAC,IAAA,oBAAc,EAAC,uCAAuC,CAAC,CAAC,CAAC,OAAO,CAAC;YACtE,UAAU,EAAE,QAAQ;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,0DAA0D;QAC1D,IAAA,eAAM,EAAC,IAAA,oBAAc,EAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC;YACpD,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,IAAA,eAAM,EAAC,IAAA,oBAAc,EAAC,oCAAoC,CAAC,CAAC,CAAC,OAAO,CAAC;YACnE,UAAU,EAAE,MAAM;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "0.0.13";
+export declare const SDK_VERSION = "0.0.15";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = '0.0.13';
+exports.SDK_VERSION = '0.0.15';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qurvo/sdk-browser",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Browser SDK for Qurvo analytics — event tracking, user identification, auto-capture",
   "license": "MIT",
   "main": "dist/index.js",
@@ -13,11 +13,12 @@
   },
   "dependencies": {
     "fflate": "^0.8.2",
-    "@qurvo/sdk-core": "0.0.9"
+    "@qurvo/sdk-core": "0.0.11"
   },
   "devDependencies": {
     "esbuild": "^0.25.0",
     "typescript": "^5.7.0",
+    "vitest": "^3.1.1",
     "@qurvo/tsconfig": "0.0.0"
   },
   "scripts": {