@cnv-vn/track 0.2.0-alpha.2

package/README.md

@@ -0,0 +1,279 @@
+# cnv-track.js
+
+> Lightweight, async-first web analytics tracker — bundle size ≤ 20 KB gzipped.
+
+`cnv-track.js` là Web JS SDK của hệ thống tracking CNV, có vai trò tương đương
+Google Analytics / Facebook Pixel: nhúng một dòng `<script>` vào website
+khách hàng, tự động thu thập ngữ cảnh và bắn sự kiện tùy chỉnh về Tracking
+Gateway nội bộ.
+
+## Trạng thái hiện tại
+
+| Task | Hạng mục                                              | Trạng thái              |
+| ---- | ----------------------------------------------------- | ----------------------- |
+| 1    | Setup môi trường & thiết kế snippet                   | ✅ Hoàn thành           |
+| 2.1  | Identity: Anonymous Client ID (cookie + localStorage) | ✅ Hoàn thành           |
+| 2.2  | Session ID (inactivity 30 phút, cookie + sessionStg)  | ✅ Hoàn thành           |
+| 2.3  | Context Collector (page / screen / UTM / click-id)    | ✅ Hoàn thành           |
+| 3    | Public API: `init`, `pageview`, `track`, `identify`   | ✅ Hoàn thành           |
+| 3.5  | Queue Processor (drain `cnvQ`, sync `.push` proxy)    | ✅ Hoàn thành           |
+| 4.1  | Transport: `sendBeacon` (ưu tiên)                     | ✅ Hoàn thành           |
+| 4.2  | Transport: Fetch / XHR fallback                       | ✅ fetch+keepalive      |
+| 4.3  | Content-Type `text/plain` → bỏ CORS preflight         | ✅ Hoàn thành           |
+| 4.4  | Offline retry queue (`localStorage` + `online`)       | ✅ Hoàn thành           |
+| 5    | QA, performance audit, cross-browser                  | ✅ 259 test / 5.5KB     |
+| 6    | Build, CDN deploy, Integration guide                  | ✅ docs-site (30 trang) |
+
+Tham khảo [kế hoạch tổng thể](./ke_hoach_phat_trien_cnv_track_js.md).
+
+### Endpoint contract
+
+| Endpoint                                     | Khi nào                              |
+| -------------------------------------------- | ------------------------------------ |
+| `POST https://cnvcdp.net/api/segment/batch`  | Mặc định — flush nhiều event / 1 req |
+| `POST https://cnvcdp.net/api/segment/{type}` | `useBatch: false` — 1 event / req    |
+
+Schema mirror nguyên `com.cnv.tracking.dto.SegmentMessage` Java DTO
+(camelCase Segment Spec). Chi tiết: [docs/SCHEMA.md](./docs/SCHEMA.md).
+
+> **CORS (Sub-task 4.3):** SDK gửi `Content-Type: text/plain` (mặc định) —
+> giá trị CORS-safelisted nên **không phát** `OPTIONS` preflight. Body vẫn là
+> JSON nguyên vẹn → **backend phải parse `text/plain` thành JSON**. Đặt
+> `contentType: 'application/json'` nếu backend bắt buộc strict (khi đó backend
+> phải allow `OPTIONS /segment/*` từ origin khách). SDK luôn gửi
+> `credentials: 'omit'` nên server có thể trả `Access-Control-Allow-Origin: *`.
+
+## Cấu trúc dự án
+
+```
+.
+├── src/
+│   ├── index.ts              # Public entry — installs queue + exports default
+│   ├── types.ts              # Segment Spec wire schema (camelCase)
+│   ├── global.d.ts           # window.cnvQ + build-time constants
+│   ├── utils/
+│   │   ├── uuid.ts           # RFC-4122 v4 generator + validator
+│   │   └── storage.ts        # Cookie + LS + sessionStorage helpers
+│   └── core/
+│       ├── identity.ts       # Anonymous Client ID resolver
+│       ├── userIdentity.ts   # Authenticated userId + traits (Sub-task 3.4)
+│       ├── session.ts        # Session ID + inactivity timeout
+│       ├── context.ts        # Context Collector (page/screen/UTM/library)
+│       ├── messageBuilder.ts # SegmentMessage factory (track/page/identify/…)
+│       ├── transport.ts      # Batch buffer + beacon/fetch flush → /segment/batch
+│       ├── retryQueue.ts     # Offline retry queue (localStorage + online replay)
+│       ├── queue.ts          # Queue Processor (drain cnvQ + sync .push proxy)
+│       └── runtime.ts        # SDK state holder + Public API dispatcher
+├── tests/
+│   ├── uuid.test.ts          # Vitest — UUID v4
+│   ├── storage.test.ts       # Vitest — cookie + LS + SS helpers
+│   ├── identity.test.ts      # Vitest — Client ID lifecycle
+│   ├── userIdentity.test.ts  # Vitest — userId / traits lifecycle
+│   ├── session.test.ts       # Vitest — Session lifecycle + timeout
+│   ├── context.test.ts       # Vitest — page/screen/UTM/library
+│   ├── messageBuilder.test.ts# Vitest — SegmentMessage factory
+│   ├── transport.test.ts     # Vitest — batch buffer, beacon/fetch, content-type
+│   ├── retryQueue.test.ts    # Vitest — offline stash + online replay
+│   ├── queue.test.ts         # Vitest — Queue Processor
+│   ├── runtime.test.ts       # Vitest — end-to-end Public API
+│   └── silentFail.test.ts    # Vitest — crash-proof / silent-fail contract
+├── snippet/
+│   ├── snippet.html      # Bản có chú thích (onboarding)
+│   ├── snippet.min.html  # Bản nén (production)
+│   └── README.md         # Cách nhúng + biến thể (GTM, SPA, consent)
+├── docs/
+│   ├── SCHEMA.md         # Data Schema Payload (human-readable)
+│   ├── IDENTITY.md       # Client ID / cookie / LS rules theo RFC 4122 + 6265bis
+│   ├── CONTEXT.md        # Context Collector — UTM, click-id, page/screen
+│   ├── TRANSPORT.md      # Transport layer — beacon/fetch/retry
+│   └── QA.md             # Task 5 — unit test, crash-proof, perf + cross-browser
+├── rollup.config.mjs     # Build matrix: IIFE + UMD + ESM + .d.ts
+├── vitest.config.ts      # Test config (jsdom env + build-const define)
+├── tsconfig.json         # TypeScript strict mode, target ES2015
+├── eslint.config.mjs     # Flat config (ESLint v9)
+└── package.json          # Scripts + size-limit budgets
+```
+
+## Build pipeline (Sub-task 1.1)
+
+Đầu ra cho mỗi lần `npm run build`:
+
+| File                     | Format | Mục đích                                  |
+| ------------------------ | :----: | ----------------------------------------- |
+| `dist/cnv-track.js`      |  IIFE  | Debug build, có sourcemap                 |
+| `dist/cnv-track.min.js`  |  IIFE  | **CDN target** — minified, < 20KB gzipped |
+| `dist/cnv-track.esm.js`  |  ESM   | Cho Webpack / Vite / Rollup consumers     |
+| `dist/cnv-track.umd.cjs` |  UMD   | Legacy CommonJS / AMD / RequireJS         |
+| `dist/types/index.d.ts`  | .d.ts  | Bundled type declarations                 |
+
+**Tại sao multi-format?** Người dùng cuối có ba loại:
+(a) chèn `<script>` trực tiếp → IIFE,
+(b) `import` qua bundler hiện đại → ESM (tree-shakable),
+(c) Node-style require / RequireJS / NoModule → UMD. Đây là pattern của Segment Analytics, Mixpanel, Amplitude.
+
+## Quick start (dev workflow)
+
+```bash
+npm install                # Cài deps lần đầu
+npm run build              # Build full matrix → dist/
+npm run build:watch        # Watch mode trong khi viết code
+npm run build:analyze      # Sinh dist/stats.html (rollup-plugin-visualizer)
+npm run type-check         # tsc --noEmit
+npm run lint               # ESLint + typescript-eslint
+npm run format             # Prettier
+npm run size               # size-limit — fail nếu vượt 20KB
+npm run verify             # type-check + lint + format:check + build + size
+```
+
+## Decisions & rationale
+
+| Quyết định                       | Lý do                                                                |
+| -------------------------------- | -------------------------------------------------------------------- |
+| **TypeScript** thay vì JS thuần  | Bắt bug ở compile time; types là docs sống cho payload schema        |
+| **Target ES2015**                | Cover 97%+ trình duyệt (caniuse 2026); IE11 đã EOL — bỏ Babel        |
+| **Rollup** thay vì Webpack       | Tree-shaking tốt hơn, format-flexible, chuẩn cho thư viện            |
+| **Terser** với 3 passes + mangle | Ép kích thước xuống — tối thiểu hóa cost-to-load cho khách hàng      |
+| **`sideEffects: false`**         | Bật full tree-shaking cho ESM consumers                              |
+| **size-limit** trong CI gate     | Bundle bloat sẽ fail PR trước khi merge — kỷ luật cứng               |
+| **Snippet protocol versioning**  | `cnvQ.v` cho phép SDK mới detect snippet cũ và migrate               |
+| **`crossOrigin="anonymous"`**    | Bật CORS để bắt lỗi qua `window.onerror` — cần cho TASK 5 telemetry  |
+| **Schema follows Segment Spec**  | Cho phép swap downstream pipeline (Segment → Snowplow → self-hosted) |
+
+## Snippet (Sub-task 1.2)
+
+361 bytes raw (≈ 240B gzipped). Đặt vào `<head>`:
+
+<!-- prettier-ignore -->
+```html
+<script>!function(w,d,s,q,u){if(w[q]&&w[q].__loaded)return;var Q=w[q]=w[q]||[];Q.t=+new Date;Q.v="1.0";Q.push(["init",u]);var f=d.getElementsByTagName(s)[0],j=d.createElement(s);j.async=1;j.defer=1;j.crossOrigin="anonymous";j.src="https://cdn.cnv.vn/cnv-track.min.js";f.parentNode.insertBefore(j,f)}(window,document,"script","cnvQ","YOUR_PROJECT_ID");</script>
+```
+
+Chi tiết: [snippet/README.md](./snippet/README.md).
+
+## Schema (Sub-task 1.3)
+
+Payload v1.0 theo Segment Spec, snake_case keys, flat `properties`,
+ISO-8601 timestamp. Đầy đủ field reference: [docs/SCHEMA.md](./docs/SCHEMA.md).
+
+## Identity & Storage (Sub-task 2.1)
+
+Anonymous Client ID (UUID v4 theo RFC 4122 §4.4), lưu kép trên first-party
+cookie (RFC 6265bis, `SameSite=Lax`, TTL 730 ngày) và localStorage để bền
+vững qua ITP và cookie-banner wipe. Đầy đủ default values, validation rules,
+browser compat matrix, và tham chiếu pháp lý (GDPR / ePrivacy / CCPA / PDPD):
+[docs/IDENTITY.md](./docs/IDENTITY.md).
+
+## Public API (Task 3)
+
+Sau khi snippet load `cnv-track.min.js`, `window.cnvTrack` và
+`window.cnvQ.push([...])` đều dispatch về cùng runtime.
+
+```ts
+// 1. Khởi tạo (snippet đã làm sẵn)
+cnvTrack.init('PRJ_XYZ', {
+  endpoint: 'https://cnvcdp.net/api', // default
+  flushAt: 20, // batch size
+  flushInterval: 5000, // ms
+  autoPageview: true, // auto fire page on init
+  contentType: 'text/plain', // default — skip CORS preflight | 'application/json'
+});
+
+// 2. Track sự kiện
+cnvTrack.track('AddToCart', { sku: 'A-1', qty: 2 });
+
+// 3. Page / Screen
+cnvTrack.pageview(); // mặc định name = document.title
+cnvTrack.page('Cart', { ref: 'email' });
+cnvTrack.screen('CartScreen', { items: 2 });
+
+// 4. Identify user
+cnvTrack.identify('u_42', { email: 'a@b.vn', name: 'Ngọc' });
+
+// 5. Alias (gộp anonymous → authenticated)
+cnvTrack.alias('u_42'); // previousId mặc định = anonymousId
+
+// 6. Group (B2B)
+cnvTrack.group('org_acme', { plan: 'enterprise' });
+
+// 7. Consent (GDPR / ePrivacy)
+cnvTrack.consent({ marketing: false });
+
+// 8. Reset (sau logout)
+cnvTrack.reset();
+
+// 9. Manual flush (trước khi unload)
+cnvTrack.flush();
+
+// 10. Hot-patch options
+cnvTrack.set({ flushAt: 1 });
+```
+
+Mỗi method tương ứng 1 verb trong `QueuedCommand` — `cnvQ.push(['track', 'A'])`
+và `cnvTrack.track('A')` là tương đương 1:1.
+
+## Context Collector (Sub-task 2.3)
+
+`collectContext()` snapshot `context.page`, `context.screen`,
+`context.locale`, `context.timezone`, `context.user_agent`, `context.library`
+và — khi URL chứa UTM/click-id — `context.campaign`. Mọi browser-API access
+đều bọc `try/catch` (silent-fail) nên không bao giờ crash host page.
+
+| Sub-collector       | Nguồn                                                  |
+| ------------------- | ------------------------------------------------------ |
+| `collectPage()`     | `location.href`, `document.title`, `document.referrer` |
+| `collectScreen()`   | `screen.{width,height}`, `devicePixelRatio`            |
+| `collectCampaign()` | `URLSearchParams` over `location.search`               |
+| `collectContext()`  | composes the above + `navigator.language` + IANA tz    |
+
+Đầy đủ: nguồn từng field, UTM key map, click-id whitelist, library
+versioning, browser compat: [docs/CONTEXT.md](./docs/CONTEXT.md).
+
+## Transport (Sub-task 4.1 – 4.4)
+
+`Transport` buffer event trong bộ nhớ rồi flush theo 4 trigger: đủ `flushAt`,
+quá `flushInterval`, `pagehide` / `visibilitychange→hidden`, hoặc `flush()` thủ
+công. Mỗi request đi qua hai tầng:
+
+| Thứ tự | Phương thức            | Khi nào dùng                           |
+| ------ | ---------------------- | -------------------------------------- |
+| 1      | `navigator.sendBeacon` | Mặc định — body là `Blob` `text/plain` |
+| 2      | `fetch` + `keepalive`  | Fallback khi beacon miss               |
+
+Beacon "miss" và rơi xuống fetch khi: trình duyệt không có `sendBeacon`,
+payload > 64KB (vượt cap của beacon), beacon queue đầy (`sendBeacon` trả
+`false`), hoặc lời gọi ném lỗi (vd. CSP chặn). Vì sao beacon là chính: trình
+duyệt cam kết gửi nền ngay cả khi tab đóng, không cần `setTimeout` giữ trang.
+
+**Content-Type (Sub-task 4.3).** Mặc định `text/plain` — nằm trong CORS-safelist
+nên trình duyệt bỏ qua `OPTIONS` preflight (beacon vì thế gửi gọn lúc unload).
+Body vẫn là JSON, chỉ header khác → **backend phải parse `text/plain` thành
+JSON**. Đổi `contentType: 'application/json'` nếu backend bắt buộc strict (khi
+đó phải allow preflight). Áp dụng cho cả Blob của beacon lẫn header của fetch.
+
+**Offline retry queue (Sub-task 4.4).** Khi mất mạng — `navigator.onLine` là
+`false`, hoặc `fetch` keepalive reject — batch lỗi được stash vào `localStorage`
+(key `_cnv_rq`) thay vì bị bỏ, rồi replay theo FIFO khi có event `online` hoặc
+khi SDK boot ở lần tải trang sau. Mỗi event giữ nguyên `originalTimestamp`, chỉ
+đóng dấu lại `sentAt`. **Không** retry với HTTP error status (4xx/5xx — là
+response, sẽ loop) hay payload > 64KB (không transport nào gửi được). Hàng đợi
+cap 100 event, evict batch cũ nhất khi đầy; mọi thao tác storage đều silent-fail.
+
+## QA & Performance (Task 5)
+
+| Hạng mục                 | Kết quả                                                              |
+| ------------------------ | -------------------------------------------------------------------- |
+| Unit test (Sub-task 5.1) | **259 test / 12 file** (Vitest) — coverage 93.85% stmt · 98.78% line |
+| Crash-proof (5.2)        | Silent-fail xuyên suốt + `silentFail.test.ts` (môi trường thù địch)  |
+| Bundle (5.3)             | IIFE **5.52 KB gzipped** / 20 KB budget (`size-limit` CI gate)       |
+| Async load (5.3)         | Snippet `async`+`defer`+`insertBefore` → zero-blocking, CLS = 0      |
+| Cross-browser (5.3)      | Chrome / Edge / Firefox / Safari (ITP) — đủ chuỗi fallback           |
+
+Mock trong test tuân thủ **contract thật** (cap 64KB beacon/keepalive được mô
+hình đúng) nên green chứng minh hành vi thật. Audit còn phát hiện + sửa một lỗi
+silent-fail thật: throw đồng bộ trong flush bất đồng bộ (timer/`pagehide`) nay
+được `Transport.send()` chặn. Đầy đủ: [docs/QA.md](./docs/QA.md).
+
+## License
+
+UNLICENSED — internal CNV project. Liên hệ team Data Platform trước khi
+re-distribute.

package/dist/cnv-track.esm.js

@@ -0,0 +1,6 @@
+/*!
+ * @cnv-vn/track v0.2.0-alpha.2
+ * (c) 2026 CNV
+ * Released under the UNLICENSED license.
+ */
+const t=["pdf","doc","docx","xls","xlsx","ppt","pptx","txt","csv","rtf","zip","rar","7z","tar","gz","mp3","mp4","mov","wav","avi","mkv","dmg","exe","pkg","apk","msi","svg"];function n(t){return!!t&&"object"==typeof t&&1===t.nodeType&&"A"===t.tagName}function e(t){const n=t.lastIndexOf("/");return-1===n?t:t.slice(n+1)}function r(t){var n,e,r;let o=(null!==(n=t.textContent)&&void 0!==n?n:"").trim();return o||(o=(null!==(e=t.getAttribute("aria-label"))&&void 0!==e?e:"").trim()),o||(o=(null!==(r=t.getAttribute("title"))&&void 0!==r?r:"").trim()),o.length>200?o.slice(0,200):o}const o="__cnvPatched";function i(){try{return"undefined"!=typeof location?location.href:""}catch(t){return""}}const c=["q","s","query","search","keyword"],u={spa:!0,outboundClicks:!0,scroll:!0,downloads:!0,siteSearch:!0},s={spa:!1,outboundClicks:!1,scroll:!1,downloads:!1,siteSearch:!1};function a(t){try{t()}catch(t){}}const l=["gclid","fbclid","ttclid","msclkid","dclid"],d=[["utm_source","source"],["utm_medium","medium"],["utm_campaign","name"],["utm_term","term"],["utm_content","content"],["utm_id","id"]];function f(t,n){try{return t()}catch(t){return n}}function h(){const t=f(()=>window.location.href,"");let n="",e="",r="";if(t)try{const o=new URL(t);n=o.pathname,e=o.search,r=o.hash}catch(t){}return{url:t,path:n,search:e,hash:r,title:f(()=>document.title,""),referrer:f(()=>document.referrer,"")}}function y(t){var n,e;let r="@cnv-vn/track",o="0.0.0-dev";try{r="@cnv-vn/track"}catch(t){}try{o="0.2.0-alpha.2"}catch(t){}return{name:null!==(n=null==t?void 0:t.name)&&void 0!==n?n:r,version:null!==(e=null==t?void 0:t.version)&&void 0!==e?e:o}}const v="0123456789abcdef";function m(t){return v[t>>>4&15]+v[15&t]}function p(){if("undefined"!=typeof crypto){if("function"==typeof crypto.randomUUID)return crypto.randomUUID();if("function"==typeof crypto.getRandomValues){const t=new Uint8Array(16);return crypto.getRandomValues(t),t[6]=15&t[6]|64,t[8]=63&t[8]|128,m(t[0])+m(t[1])+m(t[2])+m(t[3])+"-"+m(t[4])+m(t[5])+"-"+m(t[6])+m(t[7])+"-"+m(t[8])+m(t[9])+"-"+m(t[10])+m(t[11])+m(t[12])+m(t[13])+m(t[14])+m(t[15])}}return"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,t=>{const n=16*Math.random()|0;return("x"===t?n:3&n|8).toString(16)})}const b=/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;function w(t){return"string"==typeof t&&b.test(t)}const g="undefined"!=typeof window&&"undefined"!=typeof document;function x(t){if(!g)return null;try{const n=document.cookie;if(!n)return null;const e=encodeURIComponent(t),r=n.split(";");for(let n=0;n<r.length;n++){const o=r[n].indexOf("=");if(o<0)continue;const i=r[n].slice(0,o).trim();if(i===e||i===t)try{return decodeURIComponent(r[n].slice(o+1))}catch(t){return r[n].slice(o+1)}}return null}catch(t){return null}}function k(t,n,e={}){var r,o,i;if(!g)return!1;try{let c=`${encodeURIComponent(t)}=${encodeURIComponent(n)}`;if(c+=`; path=${null!==(r=e.path)&&void 0!==r?r:"/"}`,e.domain&&(c+=`; domain=${e.domain}`),"number"==typeof e.maxAgeDays){const t=Math.floor(86400*e.maxAgeDays);c+=`; max-age=${t}`,c+=`; expires=${new Date(Date.now()+1e3*t).toUTCString()}`}return c+=`; SameSite=${null!==(o=e.sameSite)&&void 0!==o?o:"Lax"}`,(null!==(i=e.secure)&&void 0!==i?i:"undefined"!=typeof location&&"https:"===location.protocol)&&(c+="; Secure"),document.cookie=c,x(t)===n}catch(t){return!1}}function j(){if(!g)return!1;try{const t="__cnv_probe__";return localStorage.setItem(t,"1"),localStorage.removeItem(t),!0}catch(t){return!1}}function O(t){if(!j())return null;try{return localStorage.getItem(t)}catch(t){return null}}function S(t,n){if(!j())return!1;try{return localStorage.setItem(t,n),!0}catch(t){return!1}}function _(t){if(!j())return!1;try{return localStorage.removeItem(t),!0}catch(t){return!1}}function A(){if(!g)return!1;try{const t="__cnv_probe__";return sessionStorage.setItem(t,"1"),sessionStorage.removeItem(t),!0}catch(t){return!1}}const P="_cnv_cid";function D(t={}){const n=x(P),e=O(P);let r=null;return w(n)?r=n:w(e)&&(r=e),r||(r=p()),I(r,t),r}function I(t,n={}){var e;k(P,t,{domain:n.cookieDomain,maxAgeDays:null!==(e=n.cookieMaxAgeDays)&&void 0!==e?e:730,sameSite:"Lax"}),S(P,t)}const M="1.0";function U(){return(new Date).toISOString()}function C(t,n){var e;const r=null!==(e=n.timestamp)&&void 0!==e?e:U(),o=Object.assign(Object.assign({},n.context),{projectId:n.projectId,schemaVersion:M}),i={type:t,messageId:p(),anonymousId:n.anonymousId,timestamp:r,originalTimestamp:r,context:o};return n.userId&&(i.userId=n.userId),n.sessionId&&(i.sessionId=n.sessionId),n.integrations&&(i.integrations=n.integrations),i}const T="_cnv_sid";function $(t){if(!t)return null;const n=t.lastIndexOf(".");if(n<0)return null;const e=t.slice(0,n),r=Number(t.slice(n+1));return!w(e)||!Number.isFinite(r)||r<=0?null:{id:e,lastActivity:r}}function L(t={}){const n=Date.now(),e=(t=>{var n;return 6e4*(null!==(n=t.timeoutMinutes)&&void 0!==n?n:30)})(t),r=$(x(T)),o=$((t=>{if(!A())return null;try{return sessionStorage.getItem(t)}catch(t){return null}})(T));let i=null;for(const t of[r,o])t&&(n-t.lastActivity>e||(!i||t.lastActivity>i.lastActivity)&&(i=t));const c=i?{id:i.id,lastActivity:n}:{id:p(),lastActivity:n};return R(c,t),c.id}function R(t,n={}){var e;const r=(t=>`${t.id}.${t.lastActivity}`)(t),o=null!==(e=n.timeoutMinutes)&&void 0!==e?e:30;k(T,r,{domain:n.cookieDomain,maxAgeDays:o/1440,sameSite:"Lax"}),((t,n)=>{if(!A())return!1;try{return sessionStorage.setItem(t,n),!0}catch(t){return!1}})(T,r)}class q{constructor(t){var n,e;Object.defineProperty(this,"config",{enumerable:!0,configurable:!0,writable:!0,value:t}),Object.defineProperty(this,"storageKey",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"maxMessages",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"flushing",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"onlineHandler",{enumerable:!0,configurable:!0,writable:!0,value:null}),this.storageKey=null!==(n=t.storageKey)&&void 0!==n?n:"_cnv_rq",this.maxMessages=null!==(e=t.maxMessages)&&void 0!==e?e:100,this.installOnlineListener()}stash(t){if(t&&0!==t.length)try{const n=this.read();for(n.push(t);n.length>1&&N(n)>this.maxMessages;)n.shift();this.write(n),this.config.debug&&console.log("[cnv-track] retry queued",t.length,"buffered",N(n))}catch(t){}}flush(){if(this.flushing||"undefined"!=typeof navigator&&!1===navigator.onLine)return Promise.resolve();const t=this.read();if(0===t.length)return Promise.resolve();this.flushing=!0,this.write([]);const n=()=>{this.flushing=!1};return t.reduce((t,n)=>t.then(()=>this.config.resend(n)),Promise.resolve()).then(n,n)}size(){return N(this.read())}clear(){try{_(this.storageKey)}catch(t){}}destroy(){if(this.onlineHandler){try{window.removeEventListener("online",this.onlineHandler)}catch(t){}this.onlineHandler=null}}installOnlineListener(){if("undefined"==typeof window)return;const t=()=>{this.flush()};try{window.addEventListener("online",t),this.onlineHandler=t}catch(t){}}read(){const t=O(this.storageKey);if(!t)return[];try{const n=JSON.parse(t);return Array.isArray(n)?n.filter(t=>Array.isArray(t)&&t.length>0):[]}catch(t){return[]}}write(t){0!==t.length?S(this.storageKey,JSON.stringify(t)):_(this.storageKey)}}function N(t){let n=0;for(const e of t)n+=e.length;return n}class B{constructor(t){Object.defineProperty(this,"config",{enumerable:!0,configurable:!0,writable:!0,value:t}),Object.defineProperty(this,"buffer",{enumerable:!0,configurable:!0,writable:!0,value:[]}),Object.defineProperty(this,"timer",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"destroyed",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"handlers",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"retryQueue",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),this.retryQueue=new q({debug:t.debug,resend:t=>this.send(t)}),this.installPageLifecycleHandlers(),this.retryQueue.flush()}setConfig(t){this.config=Object.assign(Object.assign({},this.config),t)}enqueue(t){this.destroyed||(this.buffer.push(t),this.buffer.length>=this.config.flushAt?this.flush():this.timer||(this.timer=setTimeout(()=>{this.timer=null,this.flush()},this.config.flushInterval)))}flush(){if(this.timer&&(clearTimeout(this.timer),this.timer=null),0===this.buffer.length)return Promise.resolve();const t=this.buffer;return this.buffer=[],this.send(t)}bufferedCount(){return this.buffer.length}destroy(){this.destroyed||(this.destroyed=!0,this.timer&&(clearTimeout(this.timer),this.timer=null),this.uninstallPageLifecycleHandlers(),this.retryQueue.destroy())}send(t){try{return this.config.useBatch?this.sendBatch(t):Promise.all(t.map(t=>this.sendSingle(t))).then(()=>{})}catch(t){return this.config.debug&&console.warn("[cnv-track] send failed synchronously; dropped batch",t),Promise.resolve()}}sendBatch(t){var n;const e=U(),r={batch:t.map(t=>z(t,e)),context:Object.assign(Object.assign({},null!==(n=this.config.batchContext)&&void 0!==n?n:{}),{projectId:this.config.projectId,sentAt:e}),sentAt:e};return this.post(this.batchUrl(),r,t)}sendSingle(t){const n=z(t,U());return this.post(this.singleUrl(t.type),n,[t])}batchUrl(){return this.config.endpoint+this.config.batchPath+"?projectId="+encodeURIComponent(this.config.projectId)}singleUrl(t){const n=this.config.singlePath.replace("{type}",t);return this.config.endpoint+n+"?projectId="+encodeURIComponent(this.config.projectId)}post(t,n,e){const r=JSON.stringify(n),o=((t,n)=>{try{return new Blob([t],{type:n})}catch(t){return null}})(r,this.config.contentType),i=o?o.size:(t=>{try{return new Blob([t]).size}catch(n){return t.length}})(r),c=i>65536?null:e;return c&&"undefined"!=typeof navigator&&!1===navigator.onLine?(this.retryQueue.stash(c),this.config.debug&&console.log("[cnv-track] offline; queued for retry",t),Promise.resolve()):o&&this.sendViaBeacon(t,o)?(this.config.debug&&console.log("[cnv-track] beacon",t),Promise.resolve()):this.sendViaFetch(t,r,c)}sendViaBeacon(t,n){if("undefined"==typeof navigator||"function"!=typeof navigator.sendBeacon)return!1;if(n.size>65536)return!1;try{return navigator.sendBeacon(t,n)}catch(t){return!1}}sendViaFetch(t,n,e){return"function"!=typeof fetch?(this.config.debug&&console.warn("[cnv-track] no transport available; queued for retry"),e&&this.retryQueue.stash(e),Promise.resolve()):fetch(t,{method:"POST",headers:{"Content-Type":this.config.contentType},body:n,keepalive:!0,credentials:"omit",mode:"cors"}).then(n=>{this.config.debug&&console.log("[cnv-track] fetch flushed",t,n.status)}).catch(n=>{this.config.debug&&console.warn("[cnv-track] flush failed; queued for retry",t,n),e&&this.retryQueue.stash(e)})}installPageLifecycleHandlers(){if("undefined"==typeof window||"undefined"==typeof document)return;const t=()=>{this.flush()},n=()=>{"hidden"===document.visibilityState&&this.flush()};try{window.addEventListener("pagehide",t),document.addEventListener("visibilitychange",n),this.handlers={pagehide:t,visibility:n}}catch(t){}}uninstallPageLifecycleHandlers(){if(this.handlers){try{window.removeEventListener("pagehide",this.handlers.pagehide),document.removeEventListener("visibilitychange",this.handlers.visibility)}catch(t){}this.handlers=null}}}function z(t,n){return Object.assign(Object.assign({},t),{sentAt:n})}const J="_cnv_uid",V="_cnv_traits",E={endpoint:"http://localhost:8090",batchPath:"/segment/batch",singlePath:"/segment/{type}",useBatch:!0,contentType:"text/plain",debug:!1,allowAdTracking:!0,cookieMaxAgeDays:730,sessionTimeoutMinutes:30,flushAt:20,flushInterval:5e3,autoPageview:!0,autotrack:!1,integrations:{}},H={analytics:!0,marketing:!0};function F(t,n){if(!Array.isArray(n)||0===n.length)return;const e=n;try{switch(e[0]){case"init":t.init(e[1],e[2]);break;case"pageview":t.pageview(e[1],e[2]);break;case"page":t.page(e[1],e[2]);break;case"screen":t.screen(e[1],e[2]);break;case"track":t.track(e[1],e[2]);break;case"identify":t.identify(e[1],e[2]);break;case"alias":t.alias(e[1],e[2]);break;case"group":t.group(e[1],e[2]);break;case"reset":t.reset();break;case"flush":t.flush();break;case"consent":t.consent(e[1]);break;case"set":t.set(e[1])}}catch(t){}}const G="0.2.0-alpha.2",K="@cnv-vn/track",Q=(()=>{let v=null,m=Object.assign({},E),b=Object.assign({},H),w=null,j=!1,A=null;function P(t){const n=Object.assign({},m);return t?(void 0!==t.endpoint&&(n.endpoint=(e=t.endpoint).endsWith("/")?e.slice(0,-1):e),void 0!==t.batchPath&&(n.batchPath=t.batchPath),void 0!==t.singlePath&&(n.singlePath=t.singlePath),void 0!==t.useBatch&&(n.useBatch=t.useBatch),void 0!==t.contentType&&(n.contentType=t.contentType),void 0!==t.debug&&(n.debug=t.debug),void 0!==t.allowAdTracking&&(n.allowAdTracking=t.allowAdTracking),void 0!==t.cookieDomain&&(n.cookieDomain=t.cookieDomain),void 0!==t.cookieMaxAgeDays&&(n.cookieMaxAgeDays=t.cookieMaxAgeDays),void 0!==t.sessionTimeoutMinutes&&(n.sessionTimeoutMinutes=t.sessionTimeoutMinutes),void 0!==t.flushAt&&(n.flushAt=t.flushAt),void 0!==t.flushInterval&&(n.flushInterval=t.flushInterval),void 0!==t.autoPageview&&(n.autoPageview=t.autoPageview),void 0!==t.autotrack&&(n.autotrack=t.autotrack),void 0!==t.integrations&&(n.integrations=t.integrations),n):n;var e}function M(){return w||(w=new B({endpoint:m.endpoint,batchPath:m.batchPath,singlePath:m.singlePath,useBatch:m.useBatch,contentType:m.contentType,flushAt:m.flushAt,flushInterval:m.flushInterval,projectId:null!=v?v:"",debug:m.debug}),w)}function U(){var t;if(!v)return null;const n=((t={})=>{var n;const e={page:h(),screen:{width:f(()=>window.screen.width,0),height:f(()=>window.screen.height,0),density:f(()=>window.devicePixelRatio||1,1)},locale:f(()=>navigator.language||"",""),timezone:f(()=>Intl.DateTimeFormat().resolvedOptions().timeZone||"",""),userAgent:f(()=>navigator.userAgent||"",""),library:y(t.library)},r=((t,n=!0)=>{const e=f(()=>window.location.search,"");if(!e)return;let r;try{r=new URLSearchParams(e)}catch(t){return}const o={};let i=!1;for(const[t,n]of d){const e=r.get(t);e&&e.length>0&&(o[n]=e,i=!0)}if(n){const t={};for(const n of l){const e=r.get(n);e&&e.length>0&&(t[n]=e)}Object.keys(t).length>0&&(o.clickIds=t,i=!0)}return i?o:void 0})(0,null===(n=t.allowAdTracking)||void 0===n||n);return r&&(e.campaign=r),e})({allowAdTracking:m.allowAdTracking});return b.analytics&&b.marketing||(n.consent=Object.assign({},b)),{anonymousId:D({cookieDomain:m.cookieDomain,cookieMaxAgeDays:m.cookieMaxAgeDays}),sessionId:L({cookieDomain:m.cookieDomain,timeoutMinutes:m.sessionTimeoutMinutes}),userId:null!==(t=x(J)||O(J))&&void 0!==t?t:void 0,context:n,projectId:v,integrations:Object.keys(m.integrations).length>0?m.integrations:void 0}}function T(t){m.debug&&console.warn(`[cnv-track] ${t}() called before init()`)}function $(t,n){try{const e=U();if(!e)return T("pageview");const r=((t,n,e)=>{const r=C("page",e);return t&&(r.name=t),r.properties=null!=n?n:{},r})(null!=t?t:(()=>{try{return"undefined"!=typeof document&&document.title||void 0}catch(t){return}})(),n,e);M().enqueue(r)}catch(t){}}function q(t,n){$(t,n)}function N(t,n){try{if("string"!=typeof t||0===t.length)return;const e=U();if(!e)return T("track");const r=((t,n,e)=>{const r=C("track",e);return r.event=t,r.properties=null!=n?n:{},r})(t,n,e);M().enqueue(r)}catch(t){}}return{get initialized(){return j},get projectId(){return v},init(l,d){try{if(!l||"string"!=typeof l)return;if(m=P(d),(null==d?void 0:d.consent)&&(b=Object.assign(Object.assign({},b),d.consent)),v=l,w&&w.destroy(),w=null,M(),j=!0,D({cookieDomain:m.cookieDomain,cookieMaxAgeDays:m.cookieMaxAgeDays}),L({cookieDomain:m.cookieDomain,timeoutMinutes:m.sessionTimeoutMinutes}),m.autoPageview&&$(),A){try{A()}catch(t){}A=null}m.autotrack&&(A=function(l,d){const f=void 0===(h=d)||!1===h?Object.assign(Object.assign({},s),{searchParams:c}):!0===h?Object.assign(Object.assign({},u),{searchParams:c}):{spa:null===(y=h.spa)||void 0===y||y,outboundClicks:null===(v=h.outboundClicks)||void 0===v||v,scroll:null===(m=h.scroll)||void 0===m||m,downloads:null===(p=h.downloads)||void 0===p||p,siteSearch:null===(b=h.siteSearch)||void 0===b||b,downloadExtensions:h.downloadExtensions,searchParams:null!==(w=h.searchParams)&&void 0!==w?w:c};var h,y,v,m,p,b,w;const g=[];let x=null;function k(t){if(f.siteSearch)try{const n=null!=t?t:(()=>{try{return"undefined"!=typeof location?location.href:""}catch(t){return""}})();if(n===x)return;x=n;const e=((t,n=c)=>{try{if(!t){if("undefined"==typeof location)return null;t=location.href}const e=t instanceof URL?t:new URL(t,(()=>{try{return"undefined"!=typeof location?location.href:"http://localhost/"}catch(t){return"http://localhost/"}})());if(!e.search)return null;for(const t of n){const n=e.searchParams.get(t);if(null===n)continue;const r=n.trim();if(0!==r.length)return{query:r,param:t}}return null}catch(t){return null}})(n,f.searchParams);e&&a(()=>l.track("Site Searched",{query:e.query,param:e.param}))}catch(t){}}if(f.outboundClicks||f.downloads){const o=(o=>{var i;if("undefined"==typeof document)return()=>{};const c=new Set((null!==(i=o.downloadExtensions)&&void 0!==i?i:t).map(t=>t.toLowerCase())),u=!!o.onOutbound,s=!!o.onDownload;if(!u&&!s)return()=>{};function a(t){var i,a;try{if(0!==t.button)return;if(t.defaultPrevented)return;const l=(t=>{const e="function"==typeof t.composedPath?t.composedPath():[];if(e.length>0)for(const t of e)if(n(t))return t;let r=t.target;for(;r;){if(n(r))return r;r=r.parentNode}return null})(t);if(!l)return;const d=l.getAttribute("href");if(!d)return;if(/^(javascript:|mailto:|tel:|sms:)/i.test(d))return;if(d.startsWith("#"))return;const f=(t=>{try{return new URL(t,location.href)}catch(t){return null}})(d);if(!f)return;let h=!1;if(s){const t=l.hasAttribute("download"),n=(t=>{const n=e(t),r=n.lastIndexOf(".");return r<=0||r===n.length-1?null:n.slice(r+1).toLowerCase()})(f.pathname);(t||n&&c.has(n))&&(h=!0,null===(i=o.onDownload)||void 0===i||i.call(o,{url:f.href,fileName:e(f.pathname),fileExtension:null!=n?n:"",text:r(l)}))}u&&!h&&f.host!==(()=>{try{return"undefined"!=typeof location?location.hostname:""}catch(t){return""}})()&&f.host&&(null===(a=o.onOutbound)||void 0===a||a.call(o,{url:f.href,host:f.host,text:r(l),target:l.target||"_self"}))}catch(t){}}try{document.addEventListener("click",a,!0)}catch(t){return()=>{}}return()=>{try{document.removeEventListener("click",a,!0)}catch(t){}}})({downloadExtensions:f.downloadExtensions,onOutbound:f.outboundClicks?t=>a(()=>l.track("Outbound Link Clicked",t)):void 0,onDownload:f.downloads?t=>a(()=>l.track("File Downloaded",t)):void 0});g.push(o)}let j=null;if(f.scroll&&(j=(t=>{if("undefined"==typeof window||"undefined"==typeof document)return{destroy(){},reset(){}};let n=!1,e=null,r=!1;function o(){if(e=null,!r&&!n)try{const e=document.documentElement,r=document.body,o=Math.max(e?e.scrollHeight:0,r?r.scrollHeight:0),i=Math.max(e?e.clientHeight:0,window.innerHeight||0);if(o<=i)return n=!0,c(),void t(90);((window.scrollY||(e?e.scrollTop:0)||0)+i)/o>=.9&&(n=!0,c(),t(90))}catch(t){}}function i(){if(null===e)try{e=window.requestAnimationFrame(o)}catch(t){o()}}function c(){try{window.removeEventListener("scroll",i),null!==e&&window.cancelAnimationFrame(e),e=null}catch(t){}}try{window.addEventListener("scroll",i,{passive:!0})}catch(t){try{window.addEventListener("scroll",i)}catch(t){}}try{window.requestAnimationFrame(o)}catch(t){o()}return{destroy(){r=!0,c()},reset(){if(!r){n=!1;try{window.addEventListener("scroll",i,{passive:!0})}catch(t){try{window.addEventListener("scroll",i)}catch(t){}}try{window.requestAnimationFrame(o)}catch(t){o()}}}}})(t=>{a(()=>l.track("Scrolled",{percent:t}))}),g.push(()=>null==j?void 0:j.destroy())),f.spa){const t=function(){if("undefined"==typeof window||"undefined"==typeof history)return()=>{};let t=i();function n(){try{const n=i();if(n===t)return;t=n,(t=>{a(()=>l.page()),null==j||j.reset(),k(t)})(n)}catch(t){}}const e=history.pushState,r=history.replaceState,c=!0===e[o],u=!0===r[o];if(!c){function f(...t){e.apply(this,t),n()}f[o]=!0,history.pushState=f}if(!u){function h(...t){r.apply(this,t),n()}h[o]=!0,history.replaceState=h}const s=()=>n(),d=()=>n();try{window.addEventListener("popstate",s),window.addEventListener("hashchange",d)}catch(y){}return()=>{try{window.removeEventListener("popstate",s),window.removeEventListener("hashchange",d)}catch(t){}try{!c&&history.pushState[o]&&(history.pushState=e),!u&&history.replaceState[o]&&(history.replaceState=r)}catch(t){}}}();g.push(t)}return k(),()=>{for(;g.length>0;){const t=g.pop();try{null==t||t()}catch(t){}}x=null}}({page(t,n){return q(t,n)},track(t,n){return N(t,n)}},m.autotrack))}catch(t){}},pageview:$,page:q,screen(t,n){try{const e=U();if(!e)return T("screen");const r=((t,n,e)=>{const r=C("screen",e);return t&&(r.name=t),r.properties=null!=n?n:{},r})(t,n,e);M().enqueue(r)}catch(t){}},track:N,identify(t,n){try{if("string"!=typeof t||0===t.length)return;((t,n,e={})=>{var r,o;if(t&&(k(J,t,{domain:e.cookieDomain,maxAgeDays:null!==(r=e.cookieMaxAgeDays)&&void 0!==r?r:730,sameSite:"Lax"}),S(J,t),null!=n)){const t=null!==(o=(()=>{const t=O(V);if(!t)return null;try{const n=JSON.parse(t);return n&&"object"==typeof n&&!Array.isArray(n)?n:null}catch(t){return null}})())&&void 0!==o?o:{},e=Object.assign(Object.assign({},t),n);try{S(V,JSON.stringify(e))}catch(t){}}})(t,n,{cookieDomain:m.cookieDomain,cookieMaxAgeDays:m.cookieMaxAgeDays});const e=U();if(!e)return T("identify");const r=((t,n,e)=>{var r;const o=C("identify",e);return t&&(o.userId=t),o.traits=null!==(r=n)&&void 0!==r?r:{},o})(t,n,e);M().enqueue(r)}catch(t){}},alias(t,n){try{if("string"!=typeof t||0===t.length)return;const e=U();if(!e)return T("alias");const r=((t,n,e)=>{const r=C("alias",e);return t&&(r.userId=t),r.previousId=null!=n?n:e.anonymousId,r})(t,n,e);M().enqueue(r)}catch(t){}},group(t,n){try{if("string"!=typeof t||0===t.length)return;const e=U();if(!e)return T("group");const r=((t,n,e)=>{const r=C("group",e);return r.groupId=t,r.traits=null!=n?n:{},r})(t,n,e);M().enqueue(r)}catch(t){}},reset(){try{((t={})=>{((t,n={})=>{var e;if(!g)return!1;try{let r=`${encodeURIComponent(t)}=`;return r+=`; path=${null!==(e=n.path)&&void 0!==e?e:"/"}`,n.domain&&(r+=`; domain=${n.domain}`),r+="; max-age=0",r+="; expires=Thu, 01 Jan 1970 00:00:00 GMT",document.cookie=r,null===x(t)}catch(t){return!1}})(J,{domain:t.cookieDomain}),_(J),_(V)})({cookieDomain:m.cookieDomain}),((t={})=>{I(p(),t)})({cookieDomain:m.cookieDomain,cookieMaxAgeDays:m.cookieMaxAgeDays}),((t={})=>{R({id:p(),lastActivity:Date.now()},t)})({cookieDomain:m.cookieDomain,timeoutMinutes:m.sessionTimeoutMinutes})}catch(t){}},flush(){try{w&&w.flush()}catch(t){}},consent(t){try{b=Object.assign(Object.assign({},b),t)}catch(t){}},set(t){try{m=P(t),t.consent&&(b=Object.assign(Object.assign({},b),t.consent)),w&&w.setConfig({endpoint:m.endpoint,batchPath:m.batchPath,singlePath:m.singlePath,useBatch:m.useBatch,contentType:m.contentType,flushAt:m.flushAt,flushInterval:m.flushInterval,debug:m.debug})}catch(t){}},destroy(){if(A){try{A()}catch(t){}A=null}w&&w.destroy(),w=null,j=!1,v=null,m=Object.assign({},E),b=Object.assign({},H)}}})();"undefined"!=typeof window&&(t=>{if("undefined"==typeof window)return()=>{};const n=window.cnvQ;if(n&&n.__loaded)return()=>{};const e=window.cnvQ=null!=n?n:[],r=e.splice(0,e.length);e.push.bind(e),e.push=(...n)=>{for(const e of n)F(t,e);return e.length},e.__loaded=!0;for(const n of r)F(t,n)})(Q);const W=Object.assign(Q,{version:G,name:K,schemaVersion:M});export{K as NAME,M as SCHEMA_VERSION,G as VERSION,W as default};

package/dist/cnv-track.min.js

@@ -0,0 +1,6 @@
+/*!
+ * @cnv-vn/track v0.2.0-alpha.2
+ * (c) 2026 CNV
+ * Released under the UNLICENSED license.
+ */
+!function(t){const n=["pdf","doc","docx","xls","xlsx","ppt","pptx","txt","csv","rtf","zip","rar","7z","tar","gz","mp3","mp4","mov","wav","avi","mkv","dmg","exe","pkg","apk","msi","svg"];function e(t){return!!t&&"object"==typeof t&&1===t.nodeType&&"A"===t.tagName}function r(t){const n=t.lastIndexOf("/");return-1===n?t:t.slice(n+1)}function o(t){var n,e,r;let o=(null!==(n=t.textContent)&&void 0!==n?n:"").trim();return o||(o=(null!==(e=t.getAttribute("aria-label"))&&void 0!==e?e:"").trim()),o||(o=(null!==(r=t.getAttribute("title"))&&void 0!==r?r:"").trim()),o.length>200?o.slice(0,200):o}const i="__cnvPatched";function c(){try{return"undefined"!=typeof location?location.href:""}catch(t){return""}}const u=["q","s","query","search","keyword"],s={spa:!0,outboundClicks:!0,scroll:!0,downloads:!0,siteSearch:!0},a={spa:!1,outboundClicks:!1,scroll:!1,downloads:!1,siteSearch:!1};function l(t){try{t()}catch(t){}}const d=["gclid","fbclid","ttclid","msclkid","dclid"],f=[["utm_source","source"],["utm_medium","medium"],["utm_campaign","name"],["utm_term","term"],["utm_content","content"],["utm_id","id"]];function h(t,n){try{return t()}catch(t){return n}}function y(){const t=h(()=>window.location.href,"");let n="",e="",r="";if(t)try{const o=new URL(t);n=o.pathname,e=o.search,r=o.hash}catch(t){}return{url:t,path:n,search:e,hash:r,title:h(()=>document.title,""),referrer:h(()=>document.referrer,"")}}function v(t){var n,e;let r="@cnv-vn/track",o="0.0.0-dev";try{r="@cnv-vn/track"}catch(t){}try{o="0.2.0-alpha.2"}catch(t){}return{name:null!==(n=null==t?void 0:t.name)&&void 0!==n?n:r,version:null!==(e=null==t?void 0:t.version)&&void 0!==e?e:o}}const m="0123456789abcdef";function p(t){return m[t>>>4&15]+m[15&t]}function b(){if("undefined"!=typeof crypto){if("function"==typeof crypto.randomUUID)return crypto.randomUUID();if("function"==typeof crypto.getRandomValues){const t=new Uint8Array(16);return crypto.getRandomValues(t),t[6]=15&t[6]|64,t[8]=63&t[8]|128,p(t[0])+p(t[1])+p(t[2])+p(t[3])+"-"+p(t[4])+p(t[5])+"-"+p(t[6])+p(t[7])+"-"+p(t[8])+p(t[9])+"-"+p(t[10])+p(t[11])+p(t[12])+p(t[13])+p(t[14])+p(t[15])}}return"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,t=>{const n=16*Math.random()|0;return("x"===t?n:3&n|8).toString(16)})}const w=/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;function g(t){return"string"==typeof t&&w.test(t)}const x="undefined"!=typeof window&&"undefined"!=typeof document;function k(t){if(!x)return null;try{const n=document.cookie;if(!n)return null;const e=encodeURIComponent(t),r=n.split(";");for(let n=0;n<r.length;n++){const o=r[n].indexOf("=");if(o<0)continue;const i=r[n].slice(0,o).trim();if(i===e||i===t)try{return decodeURIComponent(r[n].slice(o+1))}catch(t){return r[n].slice(o+1)}}return null}catch(t){return null}}function j(t,n,e={}){var r,o,i;if(!x)return!1;try{let c=`${encodeURIComponent(t)}=${encodeURIComponent(n)}`;if(c+=`; path=${null!==(r=e.path)&&void 0!==r?r:"/"}`,e.domain&&(c+=`; domain=${e.domain}`),"number"==typeof e.maxAgeDays){const t=Math.floor(86400*e.maxAgeDays);c+=`; max-age=${t}`,c+=`; expires=${new Date(Date.now()+1e3*t).toUTCString()}`}return c+=`; SameSite=${null!==(o=e.sameSite)&&void 0!==o?o:"Lax"}`,(null!==(i=e.secure)&&void 0!==i?i:"undefined"!=typeof location&&"https:"===location.protocol)&&(c+="; Secure"),document.cookie=c,k(t)===n}catch(t){return!1}}function O(){if(!x)return!1;try{const t="__cnv_probe__";return localStorage.setItem(t,"1"),localStorage.removeItem(t),!0}catch(t){return!1}}function _(t){if(!O())return null;try{return localStorage.getItem(t)}catch(t){return null}}function S(t,n){if(!O())return!1;try{return localStorage.setItem(t,n),!0}catch(t){return!1}}function A(t){if(!O())return!1;try{return localStorage.removeItem(t),!0}catch(t){return!1}}function P(){if(!x)return!1;try{const t="__cnv_probe__";return sessionStorage.setItem(t,"1"),sessionStorage.removeItem(t),!0}catch(t){return!1}}const D="_cnv_cid";function I(t={}){const n=k(D),e=_(D);let r=null;return g(n)?r=n:g(e)&&(r=e),r||(r=b()),M(r,t),r}function M(t,n={}){var e;j(D,t,{domain:n.cookieDomain,maxAgeDays:null!==(e=n.cookieMaxAgeDays)&&void 0!==e?e:730,sameSite:"Lax"}),S(D,t)}const U="1.0";function C(){return(new Date).toISOString()}function T(t,n){var e;const r=null!==(e=n.timestamp)&&void 0!==e?e:C(),o=Object.assign(Object.assign({},n.context),{projectId:n.projectId,schemaVersion:U}),i={type:t,messageId:b(),anonymousId:n.anonymousId,timestamp:r,originalTimestamp:r,context:o};return n.userId&&(i.userId=n.userId),n.sessionId&&(i.sessionId=n.sessionId),n.integrations&&(i.integrations=n.integrations),i}const $="_cnv_sid";function L(t){if(!t)return null;const n=t.lastIndexOf(".");if(n<0)return null;const e=t.slice(0,n),r=Number(t.slice(n+1));return!g(e)||!Number.isFinite(r)||r<=0?null:{id:e,lastActivity:r}}function R(t={}){const n=Date.now(),e=(t=>{var n;return 6e4*(null!==(n=t.timeoutMinutes)&&void 0!==n?n:30)})(t),r=L(k($)),o=L((t=>{if(!P())return null;try{return sessionStorage.getItem(t)}catch(t){return null}})($));let i=null;for(const t of[r,o])t&&(n-t.lastActivity>e||(!i||t.lastActivity>i.lastActivity)&&(i=t));const c=i?{id:i.id,lastActivity:n}:{id:b(),lastActivity:n};return q(c,t),c.id}function q(t,n={}){var e;const r=(t=>`${t.id}.${t.lastActivity}`)(t),o=null!==(e=n.timeoutMinutes)&&void 0!==e?e:30;j($,r,{domain:n.cookieDomain,maxAgeDays:o/1440,sameSite:"Lax"}),((t,n)=>{if(!P())return!1;try{return sessionStorage.setItem(t,n),!0}catch(t){return!1}})($,r)}class N{constructor(t){var n,e;Object.defineProperty(this,"config",{enumerable:!0,configurable:!0,writable:!0,value:t}),Object.defineProperty(this,"storageKey",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"maxMessages",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"flushing",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"onlineHandler",{enumerable:!0,configurable:!0,writable:!0,value:null}),this.storageKey=null!==(n=t.storageKey)&&void 0!==n?n:"_cnv_rq",this.maxMessages=null!==(e=t.maxMessages)&&void 0!==e?e:100,this.installOnlineListener()}stash(t){if(t&&0!==t.length)try{const n=this.read();for(n.push(t);n.length>1&&B(n)>this.maxMessages;)n.shift();this.write(n),this.config.debug&&console.log("[cnv-track] retry queued",t.length,"buffered",B(n))}catch(t){}}flush(){if(this.flushing||"undefined"!=typeof navigator&&!1===navigator.onLine)return Promise.resolve();const t=this.read();if(0===t.length)return Promise.resolve();this.flushing=!0,this.write([]);const n=()=>{this.flushing=!1};return t.reduce((t,n)=>t.then(()=>this.config.resend(n)),Promise.resolve()).then(n,n)}size(){return B(this.read())}clear(){try{A(this.storageKey)}catch(t){}}destroy(){if(this.onlineHandler){try{window.removeEventListener("online",this.onlineHandler)}catch(t){}this.onlineHandler=null}}installOnlineListener(){if("undefined"==typeof window)return;const t=()=>{this.flush()};try{window.addEventListener("online",t),this.onlineHandler=t}catch(t){}}read(){const t=_(this.storageKey);if(!t)return[];try{const n=JSON.parse(t);return Array.isArray(n)?n.filter(t=>Array.isArray(t)&&t.length>0):[]}catch(t){return[]}}write(t){0!==t.length?S(this.storageKey,JSON.stringify(t)):A(this.storageKey)}}function B(t){let n=0;for(const e of t)n+=e.length;return n}class z{constructor(t){Object.defineProperty(this,"config",{enumerable:!0,configurable:!0,writable:!0,value:t}),Object.defineProperty(this,"buffer",{enumerable:!0,configurable:!0,writable:!0,value:[]}),Object.defineProperty(this,"timer",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"destroyed",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"handlers",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"retryQueue",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),this.retryQueue=new N({debug:t.debug,resend:t=>this.send(t)}),this.installPageLifecycleHandlers(),this.retryQueue.flush()}setConfig(t){this.config=Object.assign(Object.assign({},this.config),t)}enqueue(t){this.destroyed||(this.buffer.push(t),this.buffer.length>=this.config.flushAt?this.flush():this.timer||(this.timer=setTimeout(()=>{this.timer=null,this.flush()},this.config.flushInterval)))}flush(){if(this.timer&&(clearTimeout(this.timer),this.timer=null),0===this.buffer.length)return Promise.resolve();const t=this.buffer;return this.buffer=[],this.send(t)}bufferedCount(){return this.buffer.length}destroy(){this.destroyed||(this.destroyed=!0,this.timer&&(clearTimeout(this.timer),this.timer=null),this.uninstallPageLifecycleHandlers(),this.retryQueue.destroy())}send(t){try{return this.config.useBatch?this.sendBatch(t):Promise.all(t.map(t=>this.sendSingle(t))).then(()=>{})}catch(t){return this.config.debug&&console.warn("[cnv-track] send failed synchronously; dropped batch",t),Promise.resolve()}}sendBatch(t){var n;const e=C(),r={batch:t.map(t=>J(t,e)),context:Object.assign(Object.assign({},null!==(n=this.config.batchContext)&&void 0!==n?n:{}),{projectId:this.config.projectId,sentAt:e}),sentAt:e};return this.post(this.batchUrl(),r,t)}sendSingle(t){const n=J(t,C());return this.post(this.singleUrl(t.type),n,[t])}batchUrl(){return this.config.endpoint+this.config.batchPath+"?projectId="+encodeURIComponent(this.config.projectId)}singleUrl(t){const n=this.config.singlePath.replace("{type}",t);return this.config.endpoint+n+"?projectId="+encodeURIComponent(this.config.projectId)}post(t,n,e){const r=JSON.stringify(n),o=((t,n)=>{try{return new Blob([t],{type:n})}catch(t){return null}})(r,this.config.contentType),i=o?o.size:(t=>{try{return new Blob([t]).size}catch(n){return t.length}})(r),c=i>65536?null:e;return c&&"undefined"!=typeof navigator&&!1===navigator.onLine?(this.retryQueue.stash(c),this.config.debug&&console.log("[cnv-track] offline; queued for retry",t),Promise.resolve()):o&&this.sendViaBeacon(t,o)?(this.config.debug&&console.log("[cnv-track] beacon",t),Promise.resolve()):this.sendViaFetch(t,r,c)}sendViaBeacon(t,n){if("undefined"==typeof navigator||"function"!=typeof navigator.sendBeacon)return!1;if(n.size>65536)return!1;try{return navigator.sendBeacon(t,n)}catch(t){return!1}}sendViaFetch(t,n,e){return"function"!=typeof fetch?(this.config.debug&&console.warn("[cnv-track] no transport available; queued for retry"),e&&this.retryQueue.stash(e),Promise.resolve()):fetch(t,{method:"POST",headers:{"Content-Type":this.config.contentType},body:n,keepalive:!0,credentials:"omit",mode:"cors"}).then(n=>{this.config.debug&&console.log("[cnv-track] fetch flushed",t,n.status)}).catch(n=>{this.config.debug&&console.warn("[cnv-track] flush failed; queued for retry",t,n),e&&this.retryQueue.stash(e)})}installPageLifecycleHandlers(){if("undefined"==typeof window||"undefined"==typeof document)return;const t=()=>{this.flush()},n=()=>{"hidden"===document.visibilityState&&this.flush()};try{window.addEventListener("pagehide",t),document.addEventListener("visibilitychange",n),this.handlers={pagehide:t,visibility:n}}catch(t){}}uninstallPageLifecycleHandlers(){if(this.handlers){try{window.removeEventListener("pagehide",this.handlers.pagehide),document.removeEventListener("visibilitychange",this.handlers.visibility)}catch(t){}this.handlers=null}}}function J(t,n){return Object.assign(Object.assign({},t),{sentAt:n})}const V="_cnv_uid",E="_cnv_traits",H={endpoint:"http://localhost:8090",batchPath:"/segment/batch",singlePath:"/segment/{type}",useBatch:!0,contentType:"text/plain",debug:!1,allowAdTracking:!0,cookieMaxAgeDays:730,sessionTimeoutMinutes:30,flushAt:20,flushInterval:5e3,autoPageview:!0,autotrack:!1,integrations:{}},F={analytics:!0,marketing:!0};function G(t,n){if(!Array.isArray(n)||0===n.length)return;const e=n;try{switch(e[0]){case"init":t.init(e[1],e[2]);break;case"pageview":t.pageview(e[1],e[2]);break;case"page":t.page(e[1],e[2]);break;case"screen":t.screen(e[1],e[2]);break;case"track":t.track(e[1],e[2]);break;case"identify":t.identify(e[1],e[2]);break;case"alias":t.alias(e[1],e[2]);break;case"group":t.group(e[1],e[2]);break;case"reset":t.reset();break;case"flush":t.flush();break;case"consent":t.consent(e[1]);break;case"set":t.set(e[1])}}catch(t){}}const K="0.2.0-alpha.2",Q="@cnv-vn/track",W=(()=>{let t=null,m=Object.assign({},H),p=Object.assign({},F),w=null,g=!1,O=null;function P(t){const n=Object.assign({},m);return t?(void 0!==t.endpoint&&(n.endpoint=(e=t.endpoint).endsWith("/")?e.slice(0,-1):e),void 0!==t.batchPath&&(n.batchPath=t.batchPath),void 0!==t.singlePath&&(n.singlePath=t.singlePath),void 0!==t.useBatch&&(n.useBatch=t.useBatch),void 0!==t.contentType&&(n.contentType=t.contentType),void 0!==t.debug&&(n.debug=t.debug),void 0!==t.allowAdTracking&&(n.allowAdTracking=t.allowAdTracking),void 0!==t.cookieDomain&&(n.cookieDomain=t.cookieDomain),void 0!==t.cookieMaxAgeDays&&(n.cookieMaxAgeDays=t.cookieMaxAgeDays),void 0!==t.sessionTimeoutMinutes&&(n.sessionTimeoutMinutes=t.sessionTimeoutMinutes),void 0!==t.flushAt&&(n.flushAt=t.flushAt),void 0!==t.flushInterval&&(n.flushInterval=t.flushInterval),void 0!==t.autoPageview&&(n.autoPageview=t.autoPageview),void 0!==t.autotrack&&(n.autotrack=t.autotrack),void 0!==t.integrations&&(n.integrations=t.integrations),n):n;var e}function D(){return w||(w=new z({endpoint:m.endpoint,batchPath:m.batchPath,singlePath:m.singlePath,useBatch:m.useBatch,contentType:m.contentType,flushAt:m.flushAt,flushInterval:m.flushInterval,projectId:null!=t?t:"",debug:m.debug}),w)}function U(){var n;if(!t)return null;const e=((t={})=>{var n;const e={page:y(),screen:{width:h(()=>window.screen.width,0),height:h(()=>window.screen.height,0),density:h(()=>window.devicePixelRatio||1,1)},locale:h(()=>navigator.language||"",""),timezone:h(()=>Intl.DateTimeFormat().resolvedOptions().timeZone||"",""),userAgent:h(()=>navigator.userAgent||"",""),library:v(t.library)},r=((t,n=!0)=>{const e=h(()=>window.location.search,"");if(!e)return;let r;try{r=new URLSearchParams(e)}catch(t){return}const o={};let i=!1;for(const[t,n]of f){const e=r.get(t);e&&e.length>0&&(o[n]=e,i=!0)}if(n){const t={};for(const n of d){const e=r.get(n);e&&e.length>0&&(t[n]=e)}Object.keys(t).length>0&&(o.clickIds=t,i=!0)}return i?o:void 0})(0,null===(n=t.allowAdTracking)||void 0===n||n);return r&&(e.campaign=r),e})({allowAdTracking:m.allowAdTracking});return p.analytics&&p.marketing||(e.consent=Object.assign({},p)),{anonymousId:I({cookieDomain:m.cookieDomain,cookieMaxAgeDays:m.cookieMaxAgeDays}),sessionId:R({cookieDomain:m.cookieDomain,timeoutMinutes:m.sessionTimeoutMinutes}),userId:null!==(n=k(V)||_(V))&&void 0!==n?n:void 0,context:e,projectId:t,integrations:Object.keys(m.integrations).length>0?m.integrations:void 0}}function C(t){m.debug&&console.warn(`[cnv-track] ${t}() called before init()`)}function $(t,n){try{const e=U();if(!e)return C("pageview");const r=((t,n,e)=>{const r=T("page",e);return t&&(r.name=t),r.properties=null!=n?n:{},r})(null!=t?t:(()=>{try{return"undefined"!=typeof document&&document.title||void 0}catch(t){return}})(),n,e);D().enqueue(r)}catch(t){}}function L(t,n){$(t,n)}function N(t,n){try{if("string"!=typeof t||0===t.length)return;const e=U();if(!e)return C("track");const r=((t,n,e)=>{const r=T("track",e);return r.event=t,r.properties=null!=n?n:{},r})(t,n,e);D().enqueue(r)}catch(t){}}return{get initialized(){return g},get projectId(){return t},init(d,f){try{if(!d||"string"!=typeof d)return;if(m=P(f),(null==f?void 0:f.consent)&&(p=Object.assign(Object.assign({},p),f.consent)),t=d,w&&w.destroy(),w=null,D(),g=!0,I({cookieDomain:m.cookieDomain,cookieMaxAgeDays:m.cookieMaxAgeDays}),R({cookieDomain:m.cookieDomain,timeoutMinutes:m.sessionTimeoutMinutes}),m.autoPageview&&$(),O){try{O()}catch(t){}O=null}m.autotrack&&(O=function(t,d){const f=void 0===(h=d)||!1===h?Object.assign(Object.assign({},a),{searchParams:u}):!0===h?Object.assign(Object.assign({},s),{searchParams:u}):{spa:null===(y=h.spa)||void 0===y||y,outboundClicks:null===(v=h.outboundClicks)||void 0===v||v,scroll:null===(m=h.scroll)||void 0===m||m,downloads:null===(p=h.downloads)||void 0===p||p,siteSearch:null===(b=h.siteSearch)||void 0===b||b,downloadExtensions:h.downloadExtensions,searchParams:null!==(w=h.searchParams)&&void 0!==w?w:u};var h,y,v,m,p,b,w;const g=[];let x=null;function k(n){if(f.siteSearch)try{const e=null!=n?n:(()=>{try{return"undefined"!=typeof location?location.href:""}catch(t){return""}})();if(e===x)return;x=e;const r=((t,n=u)=>{try{if(!t){if("undefined"==typeof location)return null;t=location.href}const e=t instanceof URL?t:new URL(t,(()=>{try{return"undefined"!=typeof location?location.href:"http://localhost/"}catch(t){return"http://localhost/"}})());if(!e.search)return null;for(const t of n){const n=e.searchParams.get(t);if(null===n)continue;const r=n.trim();if(0!==r.length)return{query:r,param:t}}return null}catch(t){return null}})(e,f.searchParams);r&&l(()=>t.track("Site Searched",{query:r.query,param:r.param}))}catch(t){}}if(f.outboundClicks||f.downloads){const i=(t=>{var i;if("undefined"==typeof document)return()=>{};const c=new Set((null!==(i=t.downloadExtensions)&&void 0!==i?i:n).map(t=>t.toLowerCase())),u=!!t.onOutbound,s=!!t.onDownload;if(!u&&!s)return()=>{};function a(n){var i,a;try{if(0!==n.button)return;if(n.defaultPrevented)return;const l=(t=>{const n="function"==typeof t.composedPath?t.composedPath():[];if(n.length>0)for(const t of n)if(e(t))return t;let r=t.target;for(;r;){if(e(r))return r;r=r.parentNode}return null})(n);if(!l)return;const d=l.getAttribute("href");if(!d)return;if(/^(javascript:|mailto:|tel:|sms:)/i.test(d))return;if(d.startsWith("#"))return;const f=(t=>{try{return new URL(t,location.href)}catch(t){return null}})(d);if(!f)return;let h=!1;if(s){const n=l.hasAttribute("download"),e=(t=>{const n=r(t),e=n.lastIndexOf(".");return e<=0||e===n.length-1?null:n.slice(e+1).toLowerCase()})(f.pathname);(n||e&&c.has(e))&&(h=!0,null===(i=t.onDownload)||void 0===i||i.call(t,{url:f.href,fileName:r(f.pathname),fileExtension:null!=e?e:"",text:o(l)}))}u&&!h&&f.host!==(()=>{try{return"undefined"!=typeof location?location.hostname:""}catch(t){return""}})()&&f.host&&(null===(a=t.onOutbound)||void 0===a||a.call(t,{url:f.href,host:f.host,text:o(l),target:l.target||"_self"}))}catch(t){}}try{document.addEventListener("click",a,!0)}catch(t){return()=>{}}return()=>{try{document.removeEventListener("click",a,!0)}catch(t){}}})({downloadExtensions:f.downloadExtensions,onOutbound:f.outboundClicks?n=>l(()=>t.track("Outbound Link Clicked",n)):void 0,onDownload:f.downloads?n=>l(()=>t.track("File Downloaded",n)):void 0});g.push(i)}let j=null;if(f.scroll&&(j=(t=>{if("undefined"==typeof window||"undefined"==typeof document)return{destroy(){},reset(){}};let n=!1,e=null,r=!1;function o(){if(e=null,!r&&!n)try{const e=document.documentElement,r=document.body,o=Math.max(e?e.scrollHeight:0,r?r.scrollHeight:0),i=Math.max(e?e.clientHeight:0,window.innerHeight||0);if(o<=i)return n=!0,c(),void t(90);((window.scrollY||(e?e.scrollTop:0)||0)+i)/o>=.9&&(n=!0,c(),t(90))}catch(t){}}function i(){if(null===e)try{e=window.requestAnimationFrame(o)}catch(t){o()}}function c(){try{window.removeEventListener("scroll",i),null!==e&&window.cancelAnimationFrame(e),e=null}catch(t){}}try{window.addEventListener("scroll",i,{passive:!0})}catch(t){try{window.addEventListener("scroll",i)}catch(t){}}try{window.requestAnimationFrame(o)}catch(t){o()}return{destroy(){r=!0,c()},reset(){if(!r){n=!1;try{window.addEventListener("scroll",i,{passive:!0})}catch(t){try{window.addEventListener("scroll",i)}catch(t){}}try{window.requestAnimationFrame(o)}catch(t){o()}}}}})(n=>{l(()=>t.track("Scrolled",{percent:n}))}),g.push(()=>null==j?void 0:j.destroy())),f.spa){const n=function(){if("undefined"==typeof window||"undefined"==typeof history)return()=>{};let n=c();function e(){try{const e=c();if(e===n)return;n=e,(n=>{l(()=>t.page()),null==j||j.reset(),k(n)})(e)}catch(t){}}const r=history.pushState,o=history.replaceState,u=!0===r[i],s=!0===o[i];if(!u){function f(...t){r.apply(this,t),e()}f[i]=!0,history.pushState=f}if(!s){function h(...t){o.apply(this,t),e()}h[i]=!0,history.replaceState=h}const a=()=>e(),d=()=>e();try{window.addEventListener("popstate",a),window.addEventListener("hashchange",d)}catch(y){}return()=>{try{window.removeEventListener("popstate",a),window.removeEventListener("hashchange",d)}catch(t){}try{!u&&history.pushState[i]&&(history.pushState=r),!s&&history.replaceState[i]&&(history.replaceState=o)}catch(t){}}}();g.push(n)}return k(),()=>{for(;g.length>0;){const t=g.pop();try{null==t||t()}catch(t){}}x=null}}({page(t,n){return L(t,n)},track(t,n){return N(t,n)}},m.autotrack))}catch(t){}},pageview:$,page:L,screen(t,n){try{const e=U();if(!e)return C("screen");const r=((t,n,e)=>{const r=T("screen",e);return t&&(r.name=t),r.properties=null!=n?n:{},r})(t,n,e);D().enqueue(r)}catch(t){}},track:N,identify(t,n){try{if("string"!=typeof t||0===t.length)return;((t,n,e={})=>{var r,o;if(t&&(j(V,t,{domain:e.cookieDomain,maxAgeDays:null!==(r=e.cookieMaxAgeDays)&&void 0!==r?r:730,sameSite:"Lax"}),S(V,t),null!=n)){const t=null!==(o=(()=>{const t=_(E);if(!t)return null;try{const n=JSON.parse(t);return n&&"object"==typeof n&&!Array.isArray(n)?n:null}catch(t){return null}})())&&void 0!==o?o:{},e=Object.assign(Object.assign({},t),n);try{S(E,JSON.stringify(e))}catch(t){}}})(t,n,{cookieDomain:m.cookieDomain,cookieMaxAgeDays:m.cookieMaxAgeDays});const e=U();if(!e)return C("identify");const r=((t,n,e)=>{var r;const o=T("identify",e);return t&&(o.userId=t),o.traits=null!==(r=n)&&void 0!==r?r:{},o})(t,n,e);D().enqueue(r)}catch(t){}},alias(t,n){try{if("string"!=typeof t||0===t.length)return;const e=U();if(!e)return C("alias");const r=((t,n,e)=>{const r=T("alias",e);return t&&(r.userId=t),r.previousId=null!=n?n:e.anonymousId,r})(t,n,e);D().enqueue(r)}catch(t){}},group(t,n){try{if("string"!=typeof t||0===t.length)return;const e=U();if(!e)return C("group");const r=((t,n,e)=>{const r=T("group",e);return r.groupId=t,r.traits=null!=n?n:{},r})(t,n,e);D().enqueue(r)}catch(t){}},reset(){try{((t={})=>{((t,n={})=>{var e;if(!x)return!1;try{let r=`${encodeURIComponent(t)}=`;return r+=`; path=${null!==(e=n.path)&&void 0!==e?e:"/"}`,n.domain&&(r+=`; domain=${n.domain}`),r+="; max-age=0",r+="; expires=Thu, 01 Jan 1970 00:00:00 GMT",document.cookie=r,null===k(t)}catch(t){return!1}})(V,{domain:t.cookieDomain}),A(V),A(E)})({cookieDomain:m.cookieDomain}),((t={})=>{M(b(),t)})({cookieDomain:m.cookieDomain,cookieMaxAgeDays:m.cookieMaxAgeDays}),((t={})=>{q({id:b(),lastActivity:Date.now()},t)})({cookieDomain:m.cookieDomain,timeoutMinutes:m.sessionTimeoutMinutes})}catch(t){}},flush(){try{w&&w.flush()}catch(t){}},consent(t){try{p=Object.assign(Object.assign({},p),t)}catch(t){}},set(t){try{m=P(t),t.consent&&(p=Object.assign(Object.assign({},p),t.consent)),w&&w.setConfig({endpoint:m.endpoint,batchPath:m.batchPath,singlePath:m.singlePath,useBatch:m.useBatch,contentType:m.contentType,flushAt:m.flushAt,flushInterval:m.flushInterval,debug:m.debug})}catch(t){}},destroy(){if(O){try{O()}catch(t){}O=null}w&&w.destroy(),w=null,g=!1,t=null,m=Object.assign({},H),p=Object.assign({},F)}}})();"undefined"!=typeof window&&(t=>{if("undefined"==typeof window)return()=>{};const n=window.cnvQ;if(n&&n.__loaded)return()=>{};const e=window.cnvQ=null!=n?n:[],r=e.splice(0,e.length);e.push.bind(e),e.push=(...n)=>{for(const e of n)G(t,e);return e.length},e.__loaded=!0;for(const n of r)G(t,n)})(W);const X=Object.assign(W,{version:K,name:Q,schemaVersion:U});t.NAME=Q,t.SCHEMA_VERSION=U,t.VERSION=K,t.default=X,Object.defineProperty(t,"t",{value:!0})}(this.cnvTrack=this.cnvTrack||{});

package/dist/cnv-track.umd.cjs

@@ -0,0 +1,6 @@
+/*!
+ * @cnv-vn/track v0.2.0-alpha.2
+ * (c) 2026 CNV
+ * Released under the UNLICENSED license.
+ */
+var t,n;t=this,n=function(t){const n=["pdf","doc","docx","xls","xlsx","ppt","pptx","txt","csv","rtf","zip","rar","7z","tar","gz","mp3","mp4","mov","wav","avi","mkv","dmg","exe","pkg","apk","msi","svg"];function e(t){return!!t&&"object"==typeof t&&1===t.nodeType&&"A"===t.tagName}function r(t){const n=t.lastIndexOf("/");return-1===n?t:t.slice(n+1)}function o(t){var n,e,r;let o=(null!==(n=t.textContent)&&void 0!==n?n:"").trim();return o||(o=(null!==(e=t.getAttribute("aria-label"))&&void 0!==e?e:"").trim()),o||(o=(null!==(r=t.getAttribute("title"))&&void 0!==r?r:"").trim()),o.length>200?o.slice(0,200):o}const i="__cnvPatched";function c(){try{return"undefined"!=typeof location?location.href:""}catch(t){return""}}const u=["q","s","query","search","keyword"],s={spa:!0,outboundClicks:!0,scroll:!0,downloads:!0,siteSearch:!0},a={spa:!1,outboundClicks:!1,scroll:!1,downloads:!1,siteSearch:!1};function l(t){try{t()}catch(t){}}const d=["gclid","fbclid","ttclid","msclkid","dclid"],f=[["utm_source","source"],["utm_medium","medium"],["utm_campaign","name"],["utm_term","term"],["utm_content","content"],["utm_id","id"]];function h(t,n){try{return t()}catch(t){return n}}function y(){const t=h(()=>window.location.href,"");let n="",e="",r="";if(t)try{const o=new URL(t);n=o.pathname,e=o.search,r=o.hash}catch(t){}return{url:t,path:n,search:e,hash:r,title:h(()=>document.title,""),referrer:h(()=>document.referrer,"")}}function v(t){var n,e;let r="@cnv-vn/track",o="0.0.0-dev";try{r="@cnv-vn/track"}catch(t){}try{o="0.2.0-alpha.2"}catch(t){}return{name:null!==(n=null==t?void 0:t.name)&&void 0!==n?n:r,version:null!==(e=null==t?void 0:t.version)&&void 0!==e?e:o}}const p="0123456789abcdef";function m(t){return p[t>>>4&15]+p[15&t]}function b(){if("undefined"!=typeof crypto){if("function"==typeof crypto.randomUUID)return crypto.randomUUID();if("function"==typeof crypto.getRandomValues){const t=new Uint8Array(16);return crypto.getRandomValues(t),t[6]=15&t[6]|64,t[8]=63&t[8]|128,m(t[0])+m(t[1])+m(t[2])+m(t[3])+"-"+m(t[4])+m(t[5])+"-"+m(t[6])+m(t[7])+"-"+m(t[8])+m(t[9])+"-"+m(t[10])+m(t[11])+m(t[12])+m(t[13])+m(t[14])+m(t[15])}}return"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,t=>{const n=16*Math.random()|0;return("x"===t?n:3&n|8).toString(16)})}const w=/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;function g(t){return"string"==typeof t&&w.test(t)}const x="undefined"!=typeof window&&"undefined"!=typeof document;function k(t){if(!x)return null;try{const n=document.cookie;if(!n)return null;const e=encodeURIComponent(t),r=n.split(";");for(let n=0;n<r.length;n++){const o=r[n].indexOf("=");if(o<0)continue;const i=r[n].slice(0,o).trim();if(i===e||i===t)try{return decodeURIComponent(r[n].slice(o+1))}catch(t){return r[n].slice(o+1)}}return null}catch(t){return null}}function j(t,n,e={}){var r,o,i;if(!x)return!1;try{let c=`${encodeURIComponent(t)}=${encodeURIComponent(n)}`;if(c+=`; path=${null!==(r=e.path)&&void 0!==r?r:"/"}`,e.domain&&(c+=`; domain=${e.domain}`),"number"==typeof e.maxAgeDays){const t=Math.floor(86400*e.maxAgeDays);c+=`; max-age=${t}`,c+=`; expires=${new Date(Date.now()+1e3*t).toUTCString()}`}return c+=`; SameSite=${null!==(o=e.sameSite)&&void 0!==o?o:"Lax"}`,(null!==(i=e.secure)&&void 0!==i?i:"undefined"!=typeof location&&"https:"===location.protocol)&&(c+="; Secure"),document.cookie=c,k(t)===n}catch(t){return!1}}function O(){if(!x)return!1;try{const t="__cnv_probe__";return localStorage.setItem(t,"1"),localStorage.removeItem(t),!0}catch(t){return!1}}function _(t){if(!O())return null;try{return localStorage.getItem(t)}catch(t){return null}}function S(t,n){if(!O())return!1;try{return localStorage.setItem(t,n),!0}catch(t){return!1}}function A(t){if(!O())return!1;try{return localStorage.removeItem(t),!0}catch(t){return!1}}function P(){if(!x)return!1;try{const t="__cnv_probe__";return sessionStorage.setItem(t,"1"),sessionStorage.removeItem(t),!0}catch(t){return!1}}const D="_cnv_cid";function I(t={}){const n=k(D),e=_(D);let r=null;return g(n)?r=n:g(e)&&(r=e),r||(r=b()),M(r,t),r}function M(t,n={}){var e;j(D,t,{domain:n.cookieDomain,maxAgeDays:null!==(e=n.cookieMaxAgeDays)&&void 0!==e?e:730,sameSite:"Lax"}),S(D,t)}const T="1.0";function U(){return(new Date).toISOString()}function C(t,n){var e;const r=null!==(e=n.timestamp)&&void 0!==e?e:U(),o=Object.assign(Object.assign({},n.context),{projectId:n.projectId,schemaVersion:T}),i={type:t,messageId:b(),anonymousId:n.anonymousId,timestamp:r,originalTimestamp:r,context:o};return n.userId&&(i.userId=n.userId),n.sessionId&&(i.sessionId=n.sessionId),n.integrations&&(i.integrations=n.integrations),i}const $="_cnv_sid";function L(t){if(!t)return null;const n=t.lastIndexOf(".");if(n<0)return null;const e=t.slice(0,n),r=Number(t.slice(n+1));return!g(e)||!Number.isFinite(r)||r<=0?null:{id:e,lastActivity:r}}function R(t={}){const n=Date.now(),e=(t=>{var n;return 6e4*(null!==(n=t.timeoutMinutes)&&void 0!==n?n:30)})(t),r=L(k($)),o=L((t=>{if(!P())return null;try{return sessionStorage.getItem(t)}catch(t){return null}})($));let i=null;for(const t of[r,o])t&&(n-t.lastActivity>e||(!i||t.lastActivity>i.lastActivity)&&(i=t));const c=i?{id:i.id,lastActivity:n}:{id:b(),lastActivity:n};return q(c,t),c.id}function q(t,n={}){var e;const r=(t=>`${t.id}.${t.lastActivity}`)(t),o=null!==(e=n.timeoutMinutes)&&void 0!==e?e:30;j($,r,{domain:n.cookieDomain,maxAgeDays:o/1440,sameSite:"Lax"}),((t,n)=>{if(!P())return!1;try{return sessionStorage.setItem(t,n),!0}catch(t){return!1}})($,r)}class N{constructor(t){var n,e;Object.defineProperty(this,"config",{enumerable:!0,configurable:!0,writable:!0,value:t}),Object.defineProperty(this,"storageKey",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"maxMessages",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"flushing",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"onlineHandler",{enumerable:!0,configurable:!0,writable:!0,value:null}),this.storageKey=null!==(n=t.storageKey)&&void 0!==n?n:"_cnv_rq",this.maxMessages=null!==(e=t.maxMessages)&&void 0!==e?e:100,this.installOnlineListener()}stash(t){if(t&&0!==t.length)try{const n=this.read();for(n.push(t);n.length>1&&B(n)>this.maxMessages;)n.shift();this.write(n),this.config.debug&&console.log("[cnv-track] retry queued",t.length,"buffered",B(n))}catch(t){}}flush(){if(this.flushing||"undefined"!=typeof navigator&&!1===navigator.onLine)return Promise.resolve();const t=this.read();if(0===t.length)return Promise.resolve();this.flushing=!0,this.write([]);const n=()=>{this.flushing=!1};return t.reduce((t,n)=>t.then(()=>this.config.resend(n)),Promise.resolve()).then(n,n)}size(){return B(this.read())}clear(){try{A(this.storageKey)}catch(t){}}destroy(){if(this.onlineHandler){try{window.removeEventListener("online",this.onlineHandler)}catch(t){}this.onlineHandler=null}}installOnlineListener(){if("undefined"==typeof window)return;const t=()=>{this.flush()};try{window.addEventListener("online",t),this.onlineHandler=t}catch(t){}}read(){const t=_(this.storageKey);if(!t)return[];try{const n=JSON.parse(t);return Array.isArray(n)?n.filter(t=>Array.isArray(t)&&t.length>0):[]}catch(t){return[]}}write(t){0!==t.length?S(this.storageKey,JSON.stringify(t)):A(this.storageKey)}}function B(t){let n=0;for(const e of t)n+=e.length;return n}class z{constructor(t){Object.defineProperty(this,"config",{enumerable:!0,configurable:!0,writable:!0,value:t}),Object.defineProperty(this,"buffer",{enumerable:!0,configurable:!0,writable:!0,value:[]}),Object.defineProperty(this,"timer",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"destroyed",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"handlers",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"retryQueue",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),this.retryQueue=new N({debug:t.debug,resend:t=>this.send(t)}),this.installPageLifecycleHandlers(),this.retryQueue.flush()}setConfig(t){this.config=Object.assign(Object.assign({},this.config),t)}enqueue(t){this.destroyed||(this.buffer.push(t),this.buffer.length>=this.config.flushAt?this.flush():this.timer||(this.timer=setTimeout(()=>{this.timer=null,this.flush()},this.config.flushInterval)))}flush(){if(this.timer&&(clearTimeout(this.timer),this.timer=null),0===this.buffer.length)return Promise.resolve();const t=this.buffer;return this.buffer=[],this.send(t)}bufferedCount(){return this.buffer.length}destroy(){this.destroyed||(this.destroyed=!0,this.timer&&(clearTimeout(this.timer),this.timer=null),this.uninstallPageLifecycleHandlers(),this.retryQueue.destroy())}send(t){try{return this.config.useBatch?this.sendBatch(t):Promise.all(t.map(t=>this.sendSingle(t))).then(()=>{})}catch(t){return this.config.debug&&console.warn("[cnv-track] send failed synchronously; dropped batch",t),Promise.resolve()}}sendBatch(t){var n;const e=U(),r={batch:t.map(t=>J(t,e)),context:Object.assign(Object.assign({},null!==(n=this.config.batchContext)&&void 0!==n?n:{}),{projectId:this.config.projectId,sentAt:e}),sentAt:e};return this.post(this.batchUrl(),r,t)}sendSingle(t){const n=J(t,U());return this.post(this.singleUrl(t.type),n,[t])}batchUrl(){return this.config.endpoint+this.config.batchPath+"?projectId="+encodeURIComponent(this.config.projectId)}singleUrl(t){const n=this.config.singlePath.replace("{type}",t);return this.config.endpoint+n+"?projectId="+encodeURIComponent(this.config.projectId)}post(t,n,e){const r=JSON.stringify(n),o=((t,n)=>{try{return new Blob([t],{type:n})}catch(t){return null}})(r,this.config.contentType),i=o?o.size:(t=>{try{return new Blob([t]).size}catch(n){return t.length}})(r),c=i>65536?null:e;return c&&"undefined"!=typeof navigator&&!1===navigator.onLine?(this.retryQueue.stash(c),this.config.debug&&console.log("[cnv-track] offline; queued for retry",t),Promise.resolve()):o&&this.sendViaBeacon(t,o)?(this.config.debug&&console.log("[cnv-track] beacon",t),Promise.resolve()):this.sendViaFetch(t,r,c)}sendViaBeacon(t,n){if("undefined"==typeof navigator||"function"!=typeof navigator.sendBeacon)return!1;if(n.size>65536)return!1;try{return navigator.sendBeacon(t,n)}catch(t){return!1}}sendViaFetch(t,n,e){return"function"!=typeof fetch?(this.config.debug&&console.warn("[cnv-track] no transport available; queued for retry"),e&&this.retryQueue.stash(e),Promise.resolve()):fetch(t,{method:"POST",headers:{"Content-Type":this.config.contentType},body:n,keepalive:!0,credentials:"omit",mode:"cors"}).then(n=>{this.config.debug&&console.log("[cnv-track] fetch flushed",t,n.status)}).catch(n=>{this.config.debug&&console.warn("[cnv-track] flush failed; queued for retry",t,n),e&&this.retryQueue.stash(e)})}installPageLifecycleHandlers(){if("undefined"==typeof window||"undefined"==typeof document)return;const t=()=>{this.flush()},n=()=>{"hidden"===document.visibilityState&&this.flush()};try{window.addEventListener("pagehide",t),document.addEventListener("visibilitychange",n),this.handlers={pagehide:t,visibility:n}}catch(t){}}uninstallPageLifecycleHandlers(){if(this.handlers){try{window.removeEventListener("pagehide",this.handlers.pagehide),document.removeEventListener("visibilitychange",this.handlers.visibility)}catch(t){}this.handlers=null}}}function J(t,n){return Object.assign(Object.assign({},t),{sentAt:n})}const V="_cnv_uid",E="_cnv_traits",H={endpoint:"http://localhost:8090",batchPath:"/segment/batch",singlePath:"/segment/{type}",useBatch:!0,contentType:"text/plain",debug:!1,allowAdTracking:!0,cookieMaxAgeDays:730,sessionTimeoutMinutes:30,flushAt:20,flushInterval:5e3,autoPageview:!0,autotrack:!1,integrations:{}},F={analytics:!0,marketing:!0};function G(t,n){if(!Array.isArray(n)||0===n.length)return;const e=n;try{switch(e[0]){case"init":t.init(e[1],e[2]);break;case"pageview":t.pageview(e[1],e[2]);break;case"page":t.page(e[1],e[2]);break;case"screen":t.screen(e[1],e[2]);break;case"track":t.track(e[1],e[2]);break;case"identify":t.identify(e[1],e[2]);break;case"alias":t.alias(e[1],e[2]);break;case"group":t.group(e[1],e[2]);break;case"reset":t.reset();break;case"flush":t.flush();break;case"consent":t.consent(e[1]);break;case"set":t.set(e[1])}}catch(t){}}const K="0.2.0-alpha.2",Q="@cnv-vn/track",W=(()=>{let t=null,p=Object.assign({},H),m=Object.assign({},F),w=null,g=!1,O=null;function P(t){const n=Object.assign({},p);return t?(void 0!==t.endpoint&&(n.endpoint=(e=t.endpoint).endsWith("/")?e.slice(0,-1):e),void 0!==t.batchPath&&(n.batchPath=t.batchPath),void 0!==t.singlePath&&(n.singlePath=t.singlePath),void 0!==t.useBatch&&(n.useBatch=t.useBatch),void 0!==t.contentType&&(n.contentType=t.contentType),void 0!==t.debug&&(n.debug=t.debug),void 0!==t.allowAdTracking&&(n.allowAdTracking=t.allowAdTracking),void 0!==t.cookieDomain&&(n.cookieDomain=t.cookieDomain),void 0!==t.cookieMaxAgeDays&&(n.cookieMaxAgeDays=t.cookieMaxAgeDays),void 0!==t.sessionTimeoutMinutes&&(n.sessionTimeoutMinutes=t.sessionTimeoutMinutes),void 0!==t.flushAt&&(n.flushAt=t.flushAt),void 0!==t.flushInterval&&(n.flushInterval=t.flushInterval),void 0!==t.autoPageview&&(n.autoPageview=t.autoPageview),void 0!==t.autotrack&&(n.autotrack=t.autotrack),void 0!==t.integrations&&(n.integrations=t.integrations),n):n;var e}function D(){return w||(w=new z({endpoint:p.endpoint,batchPath:p.batchPath,singlePath:p.singlePath,useBatch:p.useBatch,contentType:p.contentType,flushAt:p.flushAt,flushInterval:p.flushInterval,projectId:null!=t?t:"",debug:p.debug}),w)}function T(){var n;if(!t)return null;const e=((t={})=>{var n;const e={page:y(),screen:{width:h(()=>window.screen.width,0),height:h(()=>window.screen.height,0),density:h(()=>window.devicePixelRatio||1,1)},locale:h(()=>navigator.language||"",""),timezone:h(()=>Intl.DateTimeFormat().resolvedOptions().timeZone||"",""),userAgent:h(()=>navigator.userAgent||"",""),library:v(t.library)},r=((t,n=!0)=>{const e=h(()=>window.location.search,"");if(!e)return;let r;try{r=new URLSearchParams(e)}catch(t){return}const o={};let i=!1;for(const[t,n]of f){const e=r.get(t);e&&e.length>0&&(o[n]=e,i=!0)}if(n){const t={};for(const n of d){const e=r.get(n);e&&e.length>0&&(t[n]=e)}Object.keys(t).length>0&&(o.clickIds=t,i=!0)}return i?o:void 0})(0,null===(n=t.allowAdTracking)||void 0===n||n);return r&&(e.campaign=r),e})({allowAdTracking:p.allowAdTracking});return m.analytics&&m.marketing||(e.consent=Object.assign({},m)),{anonymousId:I({cookieDomain:p.cookieDomain,cookieMaxAgeDays:p.cookieMaxAgeDays}),sessionId:R({cookieDomain:p.cookieDomain,timeoutMinutes:p.sessionTimeoutMinutes}),userId:null!==(n=k(V)||_(V))&&void 0!==n?n:void 0,context:e,projectId:t,integrations:Object.keys(p.integrations).length>0?p.integrations:void 0}}function U(t){p.debug&&console.warn(`[cnv-track] ${t}() called before init()`)}function $(t,n){try{const e=T();if(!e)return U("pageview");const r=((t,n,e)=>{const r=C("page",e);return t&&(r.name=t),r.properties=null!=n?n:{},r})(null!=t?t:(()=>{try{return"undefined"!=typeof document&&document.title||void 0}catch(t){return}})(),n,e);D().enqueue(r)}catch(t){}}function L(t,n){$(t,n)}function N(t,n){try{if("string"!=typeof t||0===t.length)return;const e=T();if(!e)return U("track");const r=((t,n,e)=>{const r=C("track",e);return r.event=t,r.properties=null!=n?n:{},r})(t,n,e);D().enqueue(r)}catch(t){}}return{get initialized(){return g},get projectId(){return t},init(d,f){try{if(!d||"string"!=typeof d)return;if(p=P(f),(null==f?void 0:f.consent)&&(m=Object.assign(Object.assign({},m),f.consent)),t=d,w&&w.destroy(),w=null,D(),g=!0,I({cookieDomain:p.cookieDomain,cookieMaxAgeDays:p.cookieMaxAgeDays}),R({cookieDomain:p.cookieDomain,timeoutMinutes:p.sessionTimeoutMinutes}),p.autoPageview&&$(),O){try{O()}catch(t){}O=null}p.autotrack&&(O=function(t,d){const f=void 0===(h=d)||!1===h?Object.assign(Object.assign({},a),{searchParams:u}):!0===h?Object.assign(Object.assign({},s),{searchParams:u}):{spa:null===(y=h.spa)||void 0===y||y,outboundClicks:null===(v=h.outboundClicks)||void 0===v||v,scroll:null===(p=h.scroll)||void 0===p||p,downloads:null===(m=h.downloads)||void 0===m||m,siteSearch:null===(b=h.siteSearch)||void 0===b||b,downloadExtensions:h.downloadExtensions,searchParams:null!==(w=h.searchParams)&&void 0!==w?w:u};var h,y,v,p,m,b,w;const g=[];let x=null;function k(n){if(f.siteSearch)try{const e=null!=n?n:(()=>{try{return"undefined"!=typeof location?location.href:""}catch(t){return""}})();if(e===x)return;x=e;const r=((t,n=u)=>{try{if(!t){if("undefined"==typeof location)return null;t=location.href}const e=t instanceof URL?t:new URL(t,(()=>{try{return"undefined"!=typeof location?location.href:"http://localhost/"}catch(t){return"http://localhost/"}})());if(!e.search)return null;for(const t of n){const n=e.searchParams.get(t);if(null===n)continue;const r=n.trim();if(0!==r.length)return{query:r,param:t}}return null}catch(t){return null}})(e,f.searchParams);r&&l(()=>t.track("Site Searched",{query:r.query,param:r.param}))}catch(t){}}if(f.outboundClicks||f.downloads){const i=(t=>{var i;if("undefined"==typeof document)return()=>{};const c=new Set((null!==(i=t.downloadExtensions)&&void 0!==i?i:n).map(t=>t.toLowerCase())),u=!!t.onOutbound,s=!!t.onDownload;if(!u&&!s)return()=>{};function a(n){var i,a;try{if(0!==n.button)return;if(n.defaultPrevented)return;const l=(t=>{const n="function"==typeof t.composedPath?t.composedPath():[];if(n.length>0)for(const t of n)if(e(t))return t;let r=t.target;for(;r;){if(e(r))return r;r=r.parentNode}return null})(n);if(!l)return;const d=l.getAttribute("href");if(!d)return;if(/^(javascript:|mailto:|tel:|sms:)/i.test(d))return;if(d.startsWith("#"))return;const f=(t=>{try{return new URL(t,location.href)}catch(t){return null}})(d);if(!f)return;let h=!1;if(s){const n=l.hasAttribute("download"),e=(t=>{const n=r(t),e=n.lastIndexOf(".");return e<=0||e===n.length-1?null:n.slice(e+1).toLowerCase()})(f.pathname);(n||e&&c.has(e))&&(h=!0,null===(i=t.onDownload)||void 0===i||i.call(t,{url:f.href,fileName:r(f.pathname),fileExtension:null!=e?e:"",text:o(l)}))}u&&!h&&f.host!==(()=>{try{return"undefined"!=typeof location?location.hostname:""}catch(t){return""}})()&&f.host&&(null===(a=t.onOutbound)||void 0===a||a.call(t,{url:f.href,host:f.host,text:o(l),target:l.target||"_self"}))}catch(t){}}try{document.addEventListener("click",a,!0)}catch(t){return()=>{}}return()=>{try{document.removeEventListener("click",a,!0)}catch(t){}}})({downloadExtensions:f.downloadExtensions,onOutbound:f.outboundClicks?n=>l(()=>t.track("Outbound Link Clicked",n)):void 0,onDownload:f.downloads?n=>l(()=>t.track("File Downloaded",n)):void 0});g.push(i)}let j=null;if(f.scroll&&(j=(t=>{if("undefined"==typeof window||"undefined"==typeof document)return{destroy(){},reset(){}};let n=!1,e=null,r=!1;function o(){if(e=null,!r&&!n)try{const e=document.documentElement,r=document.body,o=Math.max(e?e.scrollHeight:0,r?r.scrollHeight:0),i=Math.max(e?e.clientHeight:0,window.innerHeight||0);if(o<=i)return n=!0,c(),void t(90);((window.scrollY||(e?e.scrollTop:0)||0)+i)/o>=.9&&(n=!0,c(),t(90))}catch(t){}}function i(){if(null===e)try{e=window.requestAnimationFrame(o)}catch(t){o()}}function c(){try{window.removeEventListener("scroll",i),null!==e&&window.cancelAnimationFrame(e),e=null}catch(t){}}try{window.addEventListener("scroll",i,{passive:!0})}catch(t){try{window.addEventListener("scroll",i)}catch(t){}}try{window.requestAnimationFrame(o)}catch(t){o()}return{destroy(){r=!0,c()},reset(){if(!r){n=!1;try{window.addEventListener("scroll",i,{passive:!0})}catch(t){try{window.addEventListener("scroll",i)}catch(t){}}try{window.requestAnimationFrame(o)}catch(t){o()}}}}})(n=>{l(()=>t.track("Scrolled",{percent:n}))}),g.push(()=>null==j?void 0:j.destroy())),f.spa){const n=function(){if("undefined"==typeof window||"undefined"==typeof history)return()=>{};let n=c();function e(){try{const e=c();if(e===n)return;n=e,(n=>{l(()=>t.page()),null==j||j.reset(),k(n)})(e)}catch(t){}}const r=history.pushState,o=history.replaceState,u=!0===r[i],s=!0===o[i];if(!u){function f(...t){r.apply(this,t),e()}f[i]=!0,history.pushState=f}if(!s){function h(...t){o.apply(this,t),e()}h[i]=!0,history.replaceState=h}const a=()=>e(),d=()=>e();try{window.addEventListener("popstate",a),window.addEventListener("hashchange",d)}catch(y){}return()=>{try{window.removeEventListener("popstate",a),window.removeEventListener("hashchange",d)}catch(t){}try{!u&&history.pushState[i]&&(history.pushState=r),!s&&history.replaceState[i]&&(history.replaceState=o)}catch(t){}}}();g.push(n)}return k(),()=>{for(;g.length>0;){const t=g.pop();try{null==t||t()}catch(t){}}x=null}}({page:(t,n)=>L(t,n),track:(t,n)=>N(t,n)},p.autotrack))}catch(t){}},pageview:$,page:L,screen(t,n){try{const e=T();if(!e)return U("screen");const r=((t,n,e)=>{const r=C("screen",e);return t&&(r.name=t),r.properties=null!=n?n:{},r})(t,n,e);D().enqueue(r)}catch(t){}},track:N,identify(t,n){try{if("string"!=typeof t||0===t.length)return;((t,n,e={})=>{var r,o;if(t&&(j(V,t,{domain:e.cookieDomain,maxAgeDays:null!==(r=e.cookieMaxAgeDays)&&void 0!==r?r:730,sameSite:"Lax"}),S(V,t),null!=n)){const t=null!==(o=(()=>{const t=_(E);if(!t)return null;try{const n=JSON.parse(t);return n&&"object"==typeof n&&!Array.isArray(n)?n:null}catch(t){return null}})())&&void 0!==o?o:{},e=Object.assign(Object.assign({},t),n);try{S(E,JSON.stringify(e))}catch(t){}}})(t,n,{cookieDomain:p.cookieDomain,cookieMaxAgeDays:p.cookieMaxAgeDays});const e=T();if(!e)return U("identify");const r=((t,n,e)=>{var r;const o=C("identify",e);return t&&(o.userId=t),o.traits=null!==(r=n)&&void 0!==r?r:{},o})(t,n,e);D().enqueue(r)}catch(t){}},alias(t,n){try{if("string"!=typeof t||0===t.length)return;const e=T();if(!e)return U("alias");const r=((t,n,e)=>{const r=C("alias",e);return t&&(r.userId=t),r.previousId=null!=n?n:e.anonymousId,r})(t,n,e);D().enqueue(r)}catch(t){}},group(t,n){try{if("string"!=typeof t||0===t.length)return;const e=T();if(!e)return U("group");const r=((t,n,e)=>{const r=C("group",e);return r.groupId=t,r.traits=null!=n?n:{},r})(t,n,e);D().enqueue(r)}catch(t){}},reset(){try{((t={})=>{((t,n={})=>{var e;if(!x)return!1;try{let r=`${encodeURIComponent(t)}=`;return r+=`; path=${null!==(e=n.path)&&void 0!==e?e:"/"}`,n.domain&&(r+=`; domain=${n.domain}`),r+="; max-age=0",r+="; expires=Thu, 01 Jan 1970 00:00:00 GMT",document.cookie=r,null===k(t)}catch(t){return!1}})(V,{domain:t.cookieDomain}),A(V),A(E)})({cookieDomain:p.cookieDomain}),((t={})=>{M(b(),t)})({cookieDomain:p.cookieDomain,cookieMaxAgeDays:p.cookieMaxAgeDays}),((t={})=>{q({id:b(),lastActivity:Date.now()},t)})({cookieDomain:p.cookieDomain,timeoutMinutes:p.sessionTimeoutMinutes})}catch(t){}},flush(){try{w&&w.flush()}catch(t){}},consent(t){try{m=Object.assign(Object.assign({},m),t)}catch(t){}},set(t){try{p=P(t),t.consent&&(m=Object.assign(Object.assign({},m),t.consent)),w&&w.setConfig({endpoint:p.endpoint,batchPath:p.batchPath,singlePath:p.singlePath,useBatch:p.useBatch,contentType:p.contentType,flushAt:p.flushAt,flushInterval:p.flushInterval,debug:p.debug})}catch(t){}},destroy(){if(O){try{O()}catch(t){}O=null}w&&w.destroy(),w=null,g=!1,t=null,p=Object.assign({},H),m=Object.assign({},F)}}})();"undefined"!=typeof window&&(t=>{if("undefined"==typeof window)return()=>{};const n=window.cnvQ;if(n&&n.__loaded)return()=>{};const e=window.cnvQ=null!=n?n:[],r=e.splice(0,e.length);e.push.bind(e),e.push=(...n)=>{for(const e of n)G(t,e);return e.length},e.__loaded=!0;for(const n of r)G(t,n)})(W);const X=Object.assign(W,{version:K,name:Q,schemaVersion:T});t.NAME=Q,t.SCHEMA_VERSION=T,t.VERSION=K,t.default=X,Object.defineProperty(t,"t",{value:!0})},"object"==typeof exports&&"undefined"!=typeof module?n(exports):"function"==typeof define&&define.amd?define(["exports"],n):n((t="undefined"!=typeof globalThis?globalThis:t||self).cnvTrack={});

package/dist/types/index.d.ts

@@ -0,0 +1,449 @@
+/**
+ * ============================================================================
+ *  cnv-track.js — Data Schema (Segment Spec compatible)
+ * ============================================================================
+ *
+ *  Wire-format contract with the CNV Tracking Gateway. Mirrors the Segment
+ *  Spec common envelope (camelCase keys) so payloads decode 1:1 into the
+ *  server-side `SegmentMessage` / `SegmentBatchRequest` DTOs.
+ *
+ *  Endpoints (relative to `SDKOptions.endpoint`, default `https://cnvcdp.net/api`):
+ *
+ *    POST /segment/batch          ← N messages per request (default flush)
+ *    POST /segment/{type}         ← single-message mode (debug / unbatched)
+ *      where {type} ∈ track | identify | page | screen | group | alias
+ *
+ *  Where `projectId` lives:
+ *    - URL query param `?projectId=…`     (routing / auth at the edge)
+ *    - `BatchRequest.context.projectId`   (so backend can read off the body too)
+ *    - `SegmentMessage.context.projectId` (per-message, in case messages get
+ *                                          forwarded individually downstream)
+ *
+ *  Compatibility policy:
+ *    - Additive changes (new optional fields) → minor `SCHEMA_VERSION` bump.
+ *    - Renames / removals / type changes → bump major.
+ * ============================================================================
+ */
+/** Wire-format schema version. Stamped into `context.schemaVersion` per message. */
+declare const SCHEMA_VERSION: "1.0";
+/** ISO-8601 timestamp string with millisecond precision and timezone offset. */
+type ISOTimestamp = string;
+/** RFC-4122 v4 UUID string. */
+type UUID = string;
+/**
+ * Request `Content-Type`. `text/plain` is CORS-safelisted, so the browser
+ * skips the OPTIONS preflight (and `sendBeacon` fires cleanly during unload);
+ * `application/json` is stricter on the wire but triggers a preflight. The
+ * JSON body itself is identical either way — only the header differs. See
+ * Sub-task 4.3.
+ */
+type ContentType = 'text/plain' | 'application/json';
+/** JSON-serializable primitive. */
+type JSONPrimitive = string | number | boolean | null;
+/** Any JSON-serializable value. */
+type JSONValue = JSONPrimitive | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+/**
+ * The six message types the gateway accepts. Mirrors the regex in
+ * `@PostMapping("segment/{type:track|identify|page|screen|group|alias}")`.
+ */
+type MessageType = 'track' | 'identify' | 'page' | 'screen' | 'group' | 'alias';
+interface ContextPage {
+    /** Full URL including query string and fragment. */
+    url: string;
+    /** Pathname only (e.g., `/products/42`). */
+    path: string;
+    /** Query string including the leading `?`. Empty string if none. */
+    search: string;
+    /** Hash fragment including the leading `#`. Empty string if none. */
+    hash: string;
+    /** `document.title` at the time the event was created. */
+    title: string;
+    /** `document.referrer` — may be empty for direct visits. */
+    referrer: string;
+}
+interface ContextScreen {
+    width: number;
+    height: number;
+    /** `window.devicePixelRatio` — useful for high-DPI segmentation. */
+    density: number;
+}
+/**
+ * Marketing attribution block. Field names follow the Segment Spec:
+ *   utm_campaign → name      utm_source → source     utm_medium → medium
+ *   utm_term     → term      utm_content → content
+ *
+ * `id` and `clickIds` are CNV extensions (no Segment equivalent) — Spring
+ * Jackson will route them through `SegmentMessage.extra` if a strict mapping
+ * exists, or via `Map<String, Object>` if `context` stays loosely typed.
+ */
+interface ContextCampaign {
+    /** `utm_campaign` — Segment maps to `campaign.name`. */
+    name?: string;
+    /** `utm_source` */
+    source?: string;
+    /** `utm_medium` */
+    medium?: string;
+    /** `utm_term` */
+    term?: string;
+    /** `utm_content` */
+    content?: string;
+    /** `utm_id` — CNV extension. */
+    id?: string;
+    /**
+     * Platform click IDs (gclid, fbclid, ttclid, msclkid, dclid, ...).
+     * CNV extension — collected verbatim from the query string.
+     */
+    clickIds?: Record<string, string>;
+}
+interface ContextLibrary {
+    /** Always `@cnv/track`. */
+    name: string;
+    /** Semver string. Stamped at build time. */
+    version: string;
+}
+interface ContextConsent {
+    analytics: boolean;
+    marketing: boolean;
+}
+interface PayloadContext {
+    page?: ContextPage;
+    screen?: ContextScreen;
+    /** `navigator.language` (e.g., `vi-VN`). */
+    locale?: string;
+    /** IANA timezone (e.g., `Asia/Ho_Chi_Minh`). */
+    timezone?: string;
+    /** Verbatim `navigator.userAgent`. Gateway is expected to parse + drop. */
+    userAgent?: string;
+    library?: ContextLibrary;
+    campaign?: ContextCampaign;
+    /**
+     * Pre-consent flag. Gateway may downgrade storage or skip forwarding to
+     * marketing destinations when `marketing === false`.
+     */
+    consent?: ContextConsent;
+    /**
+     * CNV extension — projectId is duplicated here so backend code that
+     * forwards individual messages still has access to the source project
+     * without having to thread the batch-level context through.
+     */
+    projectId?: string;
+    /** SDK wire-format version. Echoed for forward-compat triage. */
+    schemaVersion?: string;
+}
+/**
+ * One event in the wire format.
+ *
+ * Field name and types deliberately mirror `com.cnv.tracking.dto.SegmentMessage`
+ * so Jackson decodes the payload into typed fields rather than the `extra`
+ * map. Any field NOT listed here will land in `extra` on the server side.
+ *
+ *   type        — Discriminator. Required.
+ *   messageId   — UUID v4 per event. Server uses for idempotent dedupe.
+ *   anonymousId — Device-level id from cookie + localStorage.
+ *   userId      — Authenticated user id (only after `identify()`).
+ *   sessionId   — Rotates after 30' inactivity. Java accepts `session_id` alias.
+ *   timestamp   — When the event was created on the client.
+ *   originalTimestamp — Stamped once on the client; never overridden during
+ *                       offline retries. Equal to `timestamp` on first send.
+ *   sentAt      — Stamped just before the request leaves the browser.
+ *
+ *   event       — Custom event name. ONLY for type=track.
+ *   name        — Page / screen name. For type=page or type=screen.
+ *   category    — Optional grouping. For type=page or type=screen.
+ *   properties  — For track / page / screen.
+ *   traits      — For identify / group.
+ *
+ *   groupId     — Required for type=group.
+ *   previousId  — Required for type=alias (the *old* id being aliased away).
+ *
+ *   context     — Auto-collected environment (see {@link PayloadContext}).
+ *   integrations— Per-destination on/off toggles (Segment convention).
+ */
+interface SegmentMessage {
+    type: MessageType;
+    messageId: UUID;
+    anonymousId: UUID;
+    userId?: string;
+    sessionId?: string;
+    timestamp: ISOTimestamp;
+    originalTimestamp: ISOTimestamp;
+    sentAt?: ISOTimestamp;
+    event?: string;
+    name?: string;
+    category?: string;
+    properties?: Record<string, JSONValue>;
+    traits?: Record<string, JSONValue>;
+    context?: PayloadContext;
+    groupId?: string;
+    previousId?: string;
+    integrations?: Record<string, JSONValue>;
+}
+/**
+ * Wrapper sent to `POST /segment/batch`. Shape matches
+ * `com.cnv.tracking.dto.SegmentBatchRequest`:
+ *
+ *   batch        — N SegmentMessage records.
+ *   context      — Batch-level context. We use it to hoist `projectId` once
+ *                  instead of repeating per message. (Per-message context
+ *                  still carries page / screen / campaign as those vary
+ *                  between events in the same batch — SPA navigation, etc.)
+ *   integrations — Batch-level destination toggles.
+ */
+interface SegmentBatchRequest {
+    batch: SegmentMessage[];
+    context?: Record<string, JSONValue>;
+    integrations?: Record<string, JSONValue>;
+    sentAt?: ISOTimestamp;
+}
+/** Argument shape for `identify(userId, traits)`. */
+interface UserTraits {
+    email?: string;
+    phone?: string;
+    name?: string;
+    firstName?: string;
+    lastName?: string;
+    createdAt?: ISOTimestamp;
+    [key: string]: JSONValue | undefined;
+}
+interface SDKOptions {
+    /** Tracking Gateway base URL. Default: `https://cnvcdp.net/api`. */
+    endpoint?: string;
+    /** Path appended for batch flush. Default: `/segment/batch`. */
+    batchPath?: string;
+    /** Per-type single-message path template. `{type}` is interpolated. */
+    singlePath?: string;
+    /** Use batch endpoint (true, default) or one request per event. */
+    useBatch?: boolean;
+    /**
+     * Request `Content-Type`. Default `text/plain` — CORS-safelisted, so no
+     * OPTIONS preflight. Switch to `application/json` only if the gateway
+     * rejects text bodies (then it must allow the preflight). See Sub-task 4.3.
+     */
+    contentType?: ContentType;
+    /** Verbose console output. */
+    debug?: boolean;
+    /** Disable marketing-related identifiers and click-id capture. */
+    allowAdTracking?: boolean;
+    /** Cookie domain (e.g., `.cnv.vn` for cross-subdomain stitching). */
+    cookieDomain?: string;
+    /** Cookie lifetime in days. Default 730 (≈ 2 years, ITP-safe upper bound). */
+    cookieMaxAgeDays?: number;
+    /** Session inactivity timeout in minutes. Default 30. */
+    sessionTimeoutMinutes?: number;
+    /** Buffered events before forced flush. Default 20. */
+    flushAt?: number;
+    /** Max ms between flushes. Default 5000. */
+    flushInterval?: number;
+    /** Fire a `pageview` automatically on `init()`. Default true. */
+    autoPageview?: boolean;
+    /**
+     * Enhanced Measurement — opt-in automatic instrumentation. Mirrors the
+     * features GA4's gtag enables by default. Pass `true` to enable every
+     * feature with sensible defaults, `false` to disable, or a granular object
+     * to flip individual features. See {@link AutotrackOptions}.
+     *
+     * Default: `false` (off, for backward compatibility).
+     */
+    autotrack?: boolean | AutotrackOptions;
+    /** Initial consent state. Default `{ analytics: true, marketing: true }`. */
+    consent?: Partial<ContextConsent>;
+    /** Per-call integrations override. */
+    integrations?: Record<string, JSONValue>;
+}
+/**
+ * Granular toggles for the built-in autotrack instrumentation. Every feature
+ * defaults to `true` when `autotrack: true`, or can be individually flipped
+ * when the user passes an object.
+ *
+ * Event names follow Segment Spec conventions where one exists, with CNV
+ * extensions for the rest:
+ *   - SPA pageview          → emits `type:"page"` (same as manual `page()`)
+ *   - Outbound link click   → `track('Outbound Link Clicked', { url, … })`
+ *   - 90% scroll depth      → `track('Scrolled', { percent: 90 })`
+ *   - File download click   → `track('File Downloaded', { url, extension, … })`
+ *   - Site search (?q= …)   → `track('Site Searched', { query })`
+ */
+interface AutotrackOptions {
+    /**
+     * Monkey-patch `history.pushState` / `history.replaceState` and listen for
+     * `popstate` + `hashchange` so SPA route changes (React Router, Vue Router,
+     * Next.js App Router, …) fire a `page()` automatically. Default `true`.
+     */
+    spa?: boolean;
+    /**
+     * Document-level click delegation. Fires `track('Outbound Link Clicked')`
+     * when the user clicks an `<a>` whose host differs from `location.host`.
+     * Default `true`.
+     */
+    outboundClicks?: boolean;
+    /**
+     * Passive scroll listener that fires `track('Scrolled', { percent: 90 })`
+     * exactly once per page when the user reaches ≥ 90% of the document height.
+     * Re-armed on SPA route change. Default `true`.
+     */
+    scroll?: boolean;
+    /**
+     * Same click delegation pipeline as `outboundClicks`. Fires
+     * `track('File Downloaded')` when an `<a href>` points at a recognized
+     * file extension (pdf, doc/docx, xls/xlsx, ppt/pptx, zip, rar, 7z, csv,
+     * txt, mp3, mp4, mov, wav, dmg, exe, pkg, gz). Default `true`.
+     */
+    downloads?: boolean;
+    /**
+     * Inspect the URL query string for common search parameter names
+     * (`q`, `s`, `query`, `search`, `keyword`) and fire
+     * `track('Site Searched', { query })` whenever a non-empty value is found
+     * at pageview time. Default `true`.
+     */
+    siteSearch?: boolean;
+    /**
+     * Additional file extensions to treat as downloads (merged with defaults).
+     * Lower-case, no leading dot.
+     */
+    downloadExtensions?: ReadonlyArray<string>;
+    /**
+     * Override the list of query parameter names checked by `siteSearch`.
+     * Order matters — first non-empty match wins.
+     */
+    searchParams?: ReadonlyArray<string>;
+}
+/**
+ * Each entry in `window.cnvQ` is a tuple `[methodName, ...args]`.
+ * The async snippet seeds the queue as a plain Array; once the SDK loads,
+ * it drains the queue and replaces `.push` with a synchronous dispatcher.
+ *
+ * Discriminated by tuple index 0 for exhaustive type-narrowing.
+ */
+type QueuedCommand = readonly ['init', string, SDKOptions?] | readonly ['pageview', string?, Record<string, JSONValue>?] | readonly ['page', string?, Record<string, JSONValue>?] | readonly ['screen', string?, Record<string, JSONValue>?] | readonly ['track', string, Record<string, JSONValue>?] | readonly ['identify', string, UserTraits?] | readonly ['alias', string, string?] | readonly ['group', string, Record<string, JSONValue>?] | readonly ['reset'] | readonly ['flush'] | readonly ['consent', Partial<ContextConsent>] | readonly ['set', Partial<SDKOptions>];
+
+/**
+ * ============================================================================
+ *  queue — Queue Processor (Sub-task 3.5)
+ * ============================================================================
+ *
+ *  The async snippet seeds `window.cnvQ = []` and pushes `[methodName, ...args]`
+ *  tuples while the SDK is still loading. Once this file runs, we:
+ *
+ *    1. Snapshot whatever the snippet pushed (the pending FIFO backlog).
+ *    2. Replace `cnvQ.push` with a proxy that *synchronously* dispatches.
+ *    3. Drain the snapshot through the dispatcher in original order.
+ *    4. Mark `cnvQ.__loaded = true` so duplicate snippet includes no-op.
+ *
+ *  Ordering note: step 2 happens BEFORE step 3 on purpose. If a dispatched
+ *  command synchronously triggers another `cnvQ.push` (e.g., a user's init
+ *  options has an `onReady` callback that fires a `track`), the new push
+ *  also goes through the proxy and stays in FIFO order with the backlog
+ *  rather than racing the drain loop.
+ *
+ *  Every dispatch is wrapped in try/catch (Sub-task 5.2 — silent-fail
+ *  contract). A malformed command MUST NOT crash the host page or stop
+ *  the rest of the queue from draining.
+ * ============================================================================
+ */
+
+/**
+ * Surface the queue forwards inbound tuples to. Each method matches one
+ * `QueuedCommand` discriminator. The runtime (in `index.ts`) implements this.
+ */
+interface Dispatcher {
+    init(projectId: string, options?: SDKOptions): void;
+    pageview(name?: string, properties?: Record<string, JSONValue>): void;
+    page(name?: string, properties?: Record<string, JSONValue>): void;
+    screen(name?: string, properties?: Record<string, JSONValue>): void;
+    track(event: string, properties?: Record<string, JSONValue>): void;
+    identify(userId: string, traits?: UserTraits): void;
+    alias(userId: string, previousId?: string): void;
+    group(groupId: string, traits?: Record<string, JSONValue>): void;
+    reset(): void;
+    flush(): void;
+    consent(state: Partial<ContextConsent>): void;
+    set(options: Partial<SDKOptions>): void;
+}
+
+/**
+ * ============================================================================
+ *  runtime — SDK state holder + public API (Sub-tasks 3.1 / 3.2 / 3.3 / 3.4)
+ * ============================================================================
+ *
+ *  Implements the {@link Dispatcher} surface consumed by the Queue Processor.
+ *  Module-scoped state (project id, resolved options, transport instance,
+ *  consent) lives here as a singleton. `createRuntime()` exists so tests can
+ *  spin up an isolated copy without leaking state between cases.
+ *
+ *  Public API and what each method does:
+ *    init(projectId, options?)         → set up runtime, build transport,
+ *                                        optionally fire an automatic pageview
+ *    pageview(name?, properties?)      → emit `type:"page"`
+ *    page(name?, properties?)          → emit `type:"page"`  (alias of pageview)
+ *    screen(name?, properties?)        → emit `type:"screen"`
+ *    track(event, properties?)         → emit `type:"track"`
+ *    identify(userId, traits?)         → emit `type:"identify"`, persist uid
+ *    alias(userId, previousId?)        → emit `type:"alias"`
+ *    group(groupId, traits?)           → emit `type:"group"`
+ *    reset()                           → rotate anonymousId, drop userId
+ *    flush()                           → force-flush the transport buffer
+ *    consent(state)                    → merge consent flags
+ *    set(options)                      → patch SDK options at runtime
+ *
+ *  Init order matters:
+ *    1. Cookie / LS reads happen on demand (lazy) — every event resolves
+ *       its own anonymousId + sessionId at message-build time so a re-init
+ *       with new cookieDomain takes effect on the very next event.
+ *    2. Transport is recreated whenever endpoint / batch settings change.
+ *
+ *  Silent-fail (Sub-task 5.2):
+ *    Every public method is wrapped in try/catch. A bug inside the SDK
+ *    MUST NEVER throw out into the host page.
+ * ============================================================================
+ */
+
+/** Public-facing handle that exposes the SDK methods + a few internals. */
+interface Runtime extends Dispatcher {
+    readonly initialized: boolean;
+    readonly projectId: string | null;
+    /** Tear down timers + listeners. Test-only in production. */
+    destroy(): void;
+}
+
+/**
+ * ============================================================================
+ *  cnv-track.js — public entry point
+ * ============================================================================
+ *
+ *  Wires the runtime (`./core/runtime.ts`) into the Queue Processor
+ *  (`./core/queue.ts`) and exposes the public API surface.
+ *
+ *  Two consumer paths:
+ *
+ *   1. Script-tag (IIFE) via snippet:
+ *        Snippet seeds `window.cnvQ`, this module auto-installs the Queue
+ *        Processor on import, drains the backlog, and starts dispatching.
+ *
+ *   2. ES module:
+ *        `import cnvTrack from '@cnv/track'`
+ *        `cnvTrack.init('PRJ_X')`
+ *        Side-effectful auto-install still runs (a no-op if `window.cnvQ`
+ *        is empty); consumers can drive the SDK directly via the default
+ *        export or by pushing tuples through `window.cnvQ`.
+ * ============================================================================
+ */
+
+/** Library version. Replaced at build time by @rollup/plugin-replace. */
+declare const VERSION: string;
+/** Library name. Replaced at build time by @rollup/plugin-replace. */
+declare const NAME: string;
+
+/**
+ * Public SDK handle. Methods correspond 1:1 with `QueuedCommand` verbs so
+ * `window.cnvQ.push(['track', 'X'])` and `cnvTrack.track('X')` are interchangeable.
+ */
+declare const cnvTrack: Runtime & {
+    version: string;
+    name: string;
+    schemaVersion: "1.0";
+};
+
+export { NAME, SCHEMA_VERSION, VERSION, cnvTrack as default };
+export type { AutotrackOptions, ContextCampaign, ContextConsent, ContextLibrary, ContextPage, ContextScreen, JSONValue, MessageType, PayloadContext, QueuedCommand, SDKOptions, SegmentBatchRequest, SegmentMessage, UserTraits };

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "@cnv-vn/track",
+  "version": "0.2.0-alpha.2",
+  "description": "CNV Tracking SDK — lightweight, async-first web analytics tracker (<20KB gzipped).",
+  "keywords": [
+    "analytics",
+    "tracking",
+    "tag",
+    "pixel",
+    "sdk",
+    "telemetry",
+    "events",
+    "cnv"
+  ],
+  "license": "UNLICENSED",
+  "author": "CNV <dev@cnv.vn>",
+  "homepage": "https://internal.192168173.com/cnv/common/cnv-tracking",
+  "repository": {
+    "type": "git",
+    "url": "git+https://internal.192168173.com/cnv/common/cnv-tracking.git"
+  },
+  "bugs": {
+    "url": "https://internal.192168173.com/cnv/common/cnv-tracking/-/issues"
+  },
+  "type": "module",
+  "main": "./dist/cnv-track.umd.cjs",
+  "module": "./dist/cnv-track.esm.js",
+  "unpkg": "./dist/cnv-track.min.js",
+  "jsdelivr": "./dist/cnv-track.min.js",
+  "browser": "./dist/cnv-track.min.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/cnv-track.esm.js",
+      "require": "./dist/cnv-track.umd.cjs",
+      "default": "./dist/cnv-track.umd.cjs"
+    },
+    "./snippet": "./snippet/snippet.html",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/cnv-track.min.js",
+    "dist/cnv-track.esm.js",
+    "dist/cnv-track.umd.cjs",
+    "dist/types/",
+    "snippet/",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "rollup -c",
+    "build:watch": "rollup -c -w",
+    "build:analyze": "cross-env ANALYZE=true rollup -c",
+    "dev": "node scripts/dev-server.mjs",
+    "clean": "rimraf dist",
+    "prebuild": "npm run clean",
+    "size": "size-limit",
+    "size:snippet": "node -e \"const s=require('fs').statSync('snippet/snippet.min.html').size;const max=500;if(s>max){console.error('snippet/snippet.min.html ('+s+'B) exceeds budget '+max+'B');process.exit(1)}else console.log('snippet/snippet.min.html: '+s+'B / '+max+'B budget — OK')\"",
+    "type-check": "tsc --noEmit",
+    "type-check:tests": "tsc --noEmit -p tsconfig.test.json",
+    "lint": "eslint \"src/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix",
+    "format": "prettier --write \"src/**/*.{ts,js,json,md}\" \"*.{json,md,mjs}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,js,json,md}\" \"*.{json,md,mjs}\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "smoke": "node scripts/smoke-dist.mjs",
+    "verify": "npm run type-check && npm run type-check:tests && npm run lint && npm run format:check && npm run test && npm run build && npm run size && npm run size:snippet && npm run smoke"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.2",
+    "@rollup/plugin-node-resolve": "^16.0.0",
+    "@rollup/plugin-replace": "^6.0.2",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@size-limit/preset-small-lib": "^11.1.6",
+    "@types/node": "^25.9.1",
+    "@vitest/coverage-v8": "^4.1.7",
+    "cross-env": "^7.0.3",
+    "eslint": "^9.17.0",
+    "eslint-config-prettier": "^9.1.0",
+    "jsdom": "^29.1.1",
+    "prettier": "^3.4.2",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.28.1",
+    "rollup-plugin-dts": "^6.1.1",
+    "rollup-plugin-filesize": "^10.0.0",
+    "rollup-plugin-visualizer": "^5.13.1",
+    "size-limit": "^11.1.6",
+    "tslib": "^2.8.1",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.18.0",
+    "vitest": "^4.1.7"
+  },
+  "size-limit": [
+    {
+      "name": "IIFE (minified + gzipped)",
+      "path": "dist/cnv-track.min.js",
+      "limit": "20 KB",
+      "gzip": true
+    },
+    {
+      "name": "ESM tree-shaken (gzipped)",
+      "path": "dist/cnv-track.esm.js",
+      "limit": "20 KB",
+      "gzip": true
+    }
+  ]
+}

package/snippet/README.md

@@ -0,0 +1,106 @@
+# cnv-track.js — Async Snippet
+
+Đoạn mã loader bất đồng bộ nhúng vào website khách hàng. Hai biến thể:
+
+| File                | Mục đích                                  | Kích thước |
+|---------------------|-------------------------------------------|-----------:|
+| `snippet.html`      | Bản có chú thích — dùng khi onboarding    |  ~1.2 KB   |
+| `snippet.min.html`  | Bản nén — paste vào production            |   361 B    |
+
+## 1. Cách nhúng
+
+Chèn vào trong thẻ `<head>`, **trước** mọi tracking pixel khác (GTM, Meta, …):
+
+<!-- prettier-ignore -->
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <title>My Shop</title>
+
+  <!-- cnv-track.js -->
+  <script>!function(w,d,s,q,u){if(w[q]&&w[q].__loaded)return;var Q=w[q]=w[q]||[];Q.t=+new Date;Q.v="1.0";Q.push(["init",u]);var f=d.getElementsByTagName(s)[0],j=d.createElement(s);j.async=1;j.defer=1;j.crossOrigin="anonymous";j.src="https://cdn.cnv.vn/cnv-track.min.js";f.parentNode.insertBefore(j,f)}(window,document,"script","cnvQ","YOUR_PROJECT_ID");</script>
+  <!-- /cnv-track.js -->
+</head>
+```
+
+Đổi `YOUR_PROJECT_ID` thành mã dự án trong dashboard CNV.
+
+## 2. Gọi sự kiện trước khi SDK tải xong
+
+Snippet đã tạo sẵn hàng đợi `window.cnvQ`. Bạn có thể `push` ngay sau khi
+snippet chạy — sự kiện sẽ được "phát lại" khi `cnv-track.min.js` tải xong.
+
+```html
+<button id="cta">Thêm vào giỏ</button>
+<script>
+  document.getElementById('cta').addEventListener('click', function () {
+    cnvQ.push(['track', 'AddToCart', { product_id: 'SKU-42', price: 199000 }]);
+  });
+</script>
+```
+
+## 3. Các API mà queue chấp nhận
+
+| Tuple                                    | Ý nghĩa                                            |
+|------------------------------------------|----------------------------------------------------|
+| `['init', projectId, options?]`          | (Snippet tự gọi) khởi tạo SDK                      |
+| `['pageview', props?]`                   | Bắn pageview thủ công (cần thiết cho SPA)          |
+| `['track', eventName, props?]`           | Sự kiện tùy chỉnh                                  |
+| `['identify', userId, traits?]`          | Định danh user sau khi login                       |
+| `['alias', newId, prevId?]`              | Gộp danh tính ẩn danh ↔ đã định danh               |
+| `['group', groupId, traits?]`            | Gắn user vào nhóm (B2B)                            |
+| `['reset']`                              | Xóa client/session id (sau logout)                 |
+| `['consent', { analytics, marketing }]`  | Cập nhật trạng thái đồng ý cookie                  |
+| `['set', options]`                       | Thay đổi SDKOptions runtime                        |
+
+## 4. Đặc tính kỹ thuật của snippet
+
+- **Async + defer**: trình duyệt không bao giờ chặn render vì script này.
+- **`crossOrigin="anonymous"`**: bật CORS để bắt được lỗi qua `window.onerror`.
+- **Insert-before-first-script**: kỹ thuật DOM an toàn nhất — luôn có một
+  `<script>` tham chiếu hợp lệ kể cả khi `<head>` rỗng.
+- **Double-include guard** (`__loaded`): paste 2 lần không gây hỏng SDK.
+- **Boot timing** (`cnvQ.t`): SDK so sánh với `performance.now()` để báo cáo
+  thời gian khởi động lên gateway.
+- **Snippet protocol version** (`cnvQ.v = "1.0"`): cho phép SDK upgrade
+  ngược tương thích với snippet cũ.
+
+## 5. Các biến thể tích hợp
+
+### 5.1. Google Tag Manager
+
+Tạo **Custom HTML Tag**, dán nội dung `snippet.min.html`, trigger `Initialization
+- All Pages`. **Không** dùng trigger `Page View` (quá muộn).
+
+### 5.2. Single Page Applications (React / Vue / Next.js)
+
+Vẫn dùng cùng snippet ở `<head>`. Mỗi lần route thay đổi, gọi:
+
+```js
+window.cnvQ.push(['pageview']);
+```
+
+> SDK tự thu thập `window.location.href`, `document.title` tại thời điểm
+> push — không cần truyền tay.
+
+### 5.3. Có cookie consent banner
+
+Đặt snippet ở `<head>` (vô hại — chưa gửi gì). Sau khi user đồng ý:
+
+```js
+window.cnvQ.push(['consent', { analytics: true, marketing: true }]);
+```
+
+SDK chỉ bắt đầu gửi sự kiện sau khi nhận lệnh `consent`.
+
+## 6. Kiểm tra snippet hoạt động
+
+```js
+// DevTools console
+window.cnvQ;            // → Array có boot time và lệnh 'init'
+window.cnvQ.__loaded;   // → true sau khi cnv-track.min.js tải xong
+performance.getEntriesByName('https://cdn.cnv.vn/cnv-track.min.js')[0];
+// → kiểm tra đã async load, không chặn LCP/TBT
+```

package/snippet/snippet.html

@@ -0,0 +1,28 @@
+<!-- ============================================================ -->
+<!--  cnv-track.js — async loader snippet  (snippet protocol v1.0) -->
+<!--  Drop into <head>, BEFORE any other tracking / pixel script.  -->
+<!--                                                                -->
+<!--  Steps before going live:                                      -->
+<!--    1. Replace YOUR_PROJECT_ID with the id from CNV dashboard.   -->
+<!--    2. (Optional) Replace cdn.cnv.vn if you self-host the SDK.   -->
+<!--    3. Verify in DevTools → Network: cnv-track.min.js is async.  -->
+<!-- ============================================================ -->
+<script>
+  (function (w, d, s, q, u) {
+    // Double-include guard — second snippet wins nothing.
+    if (w[q] && w[q].__loaded) return;
+    var Q = (w[q] = w[q] || []);
+    Q.t = +new Date();   // boot timestamp — used by perf audit + telemetry
+    Q.v = '1.0';         // snippet protocol version
+    Q.push(['init', u]);
+
+    var f = d.getElementsByTagName(s)[0];
+    var j = d.createElement(s);
+    j.async = true;
+    j.defer = true;
+    j.crossOrigin = 'anonymous';
+    j.src = 'https://cdn.cnv.vn/cnv-track.min.js';
+    f.parentNode.insertBefore(j, f);
+  })(window, document, 'script', 'cnvQ', 'YOUR_PROJECT_ID');
+</script>
+<!-- End cnv-track.js -->

package/snippet/snippet.min.html

@@ -0,0 +1 @@
+<script>!function(w,d,s,q,u){if(w[q]&&w[q].__loaded)return;var Q=w[q]=w[q]||[];Q.t=+new Date;Q.v="1.0";Q.push(["init",u]);var f=d.getElementsByTagName(s)[0],j=d.createElement(s);j.async=1;j.defer=1;j.crossOrigin="anonymous";j.src="https://cdn.cnv.vn/cnv-track.min.js";f.parentNode.insertBefore(j,f)}(window,document,"script","cnvQ","YOUR_PROJECT_ID");</script>