@kryptonhq/analytics 0.1.0 → 0.1.2

package/README.md

@@ -16,6 +16,8 @@ const krypton = new Krypton({
   endpoint: "https://ingest.yourdomain.com",
   autoPageview: true,
   heatmap: true,
+  consentRequired: true,
+  showConsentBanner: true,
 });
 
 krypton.track("signup_clicked", { plan: "pro" });
@@ -33,7 +35,9 @@ Use jsDelivr:
       apiKey: "kapi_xxx",
       endpoint: "https://ingest.yourdomain.com",
       autoPageview: true,
-      heatmap: true
+      heatmap: true,
+      consentRequired: true,
+      showConsentBanner: true
     });
 
     krypton.track("page_loaded");
@@ -43,6 +47,35 @@ Use jsDelivr:
 
 The CDN build exposes a global: `window.KryptonAnalytics`.
 
+## Consent (default deny + categories)
+
+The SDK supports category-level consent:
+
+- `analytics`
+- `heatmaps`
+- `geo` (browser geolocation, if granted by user)
+
+Example:
+
+```ts
+import { Krypton } from "@kryptonhq/analytics";
+
+const krypton = new Krypton({
+  apiKey: "kapi_xxx",
+  endpoint: "https://ingest.yourdomain.com",
+  heatmap: true,
+  consentRequired: true,   // default deny
+  showConsentBanner: true, // built-in popup
+});
+
+// Optional manual control
+krypton.setConsent({
+  analytics: true,
+  heatmaps: false,
+  geo: false,
+});
+```
+
 ### GA-style bootstrap snippet (single paste)
 
 ```html

package/dist/browser.global.js

@@ -1 +1,21 @@
-"use strict";var KryptonAnalytics=(()=>{var Z=Object.defineProperty;var ke=Object.getOwnPropertyDescriptor;var Se=Object.getOwnPropertyNames;var be=Object.prototype.hasOwnProperty;var Ce=(e,t)=>{for(var r in t)Z(e,r,{get:t[r],enumerable:!0})},Ie=(e,t,r,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of Se(t))!be.call(e,n)&&n!==r&&Z(e,n,{get:()=>t[n],enumerable:!(i=ke(t,n))||i.enumerable});return e};var Te=e=>Ie(Z({},"__esModule",{value:!0}),e);var at={};Ce(at,{Krypton:()=>K,default:()=>nt,init:()=>ye});var g;(function(e){e[e.Document=0]="Document",e[e.DocumentType=1]="DocumentType",e[e.Element=2]="Element",e[e.Text=3]="Text",e[e.CDATA=4]="CDATA",e[e.Comment=5]="Comment"})(g||(g={}));function xe(e){return e.nodeType===e.ELEMENT_NODE}function Ee(e){var t=e?.host;return t?.shadowRoot===e}function ee(e){return Object.prototype.toString.call(e)==="[object ShadowRoot]"}function Le(e){return e.includes(" background-clip: text;")&&!e.includes(" -webkit-background-clip: text;")&&(e=e.replace(" background-clip: text;"," -webkit-background-clip: text; background-clip: text;")),e}function te(e){try{var t=e.rules||e.cssRules;return t?Le(Array.from(t).map(Ne).join("")):null}catch{return null}}function Ne(e){var t=e.cssText;if(_e(e))try{t=te(e.styleSheet)||t}catch{}return t}function _e(e){return"styleSheet"in e}var Re=(function(){function e(){this.idNodeMap=new Map,this.nodeMetaMap=new WeakMap}return e.prototype.getId=function(t){var r;if(!t)return-1;var i=(r=this.getMeta(t))===null||r===void 0?void 0:r.id;return i??-1},e.prototype.getNode=function(t){return this.idNodeMap.get(t)||null},e.prototype.getIds=function(){return Array.from(this.idNodeMap.keys())},e.prototype.getMeta=function(t){return this.nodeMetaMap.get(t)||null},e.prototype.removeNodeFromMap=function(t){var r=this,i=this.getId(t);this.idNodeMap.delete(i),t.childNodes&&t.childNodes.forEach(function(n){return r.removeNodeFromMap(n)})},e.prototype.has=function(t){return this.idNodeMap.has(t)},e.prototype.hasNode=function(t){return this.nodeMetaMap.has(t)},e.prototype.add=function(t,r){var i=r.id;this.idNodeMap.set(i,t),this.nodeMetaMap.set(t,r)},e.prototype.replace=function(t,r){var i=this.getNode(t);if(i){var n=this.nodeMetaMap.get(i);n&&this.nodeMetaMap.set(r,n)}this.idNodeMap.set(t,r)},e.prototype.reset=function(){this.idNodeMap=new Map,this.nodeMetaMap=new WeakMap},e})();function Oe(e){var t=e.maskInputOptions,r=e.tagName,i=e.type,n=e.value,a=e.maskInputFn,c=n||"";return(t[r.toLowerCase()]||t[i])&&(a?c=a(c):c="*".repeat(c.length)),c}var ue="__rrweb_original__";function Me(e){var t=e.getContext("2d");if(!t)return!0;for(var r=50,i=0;i<e.width;i+=r)for(var n=0;n<e.height;n+=r){var a=t.getImageData,c=ue in a?a[ue]:a,l=new Uint32Array(c.call(t,i,n,Math.min(r,e.width-i),Math.min(r,e.height-n)).data.buffer);if(l.some(function(o){return o!==0}))return!1}return!0}var De=1,Ae=new RegExp("[^a-z0-9-_:]"),le=-2;function Fe(){return De++}function Pe(e){if(e instanceof HTMLFormElement)return"form";var t=e.tagName.toLowerCase().trim();return Ae.test(t)?"div":t}function Ue(e){return e.cssRules?Array.from(e.cssRules).map(function(t){return t.cssText||""}).join(""):""}function He(e){var t="";return e.indexOf("//")>-1?t=e.split("/").slice(0,3).join("/"):t=e.split("/")[0],t=t.split("?")[0],t}var z,fe,We=/url\((?:(')([^']*)'|(")(.*?)"|([^)]*))\)/gm,Ge=/^(?!www\.|(?:http|ftp)s?:\/\/|[A-Za-z]:\\|\/\/|#).*/,ze=/^(data:)([^,]*),(.*)/i;function $(e,t){return(e||"").replace(We,function(r,i,n,a,c,l){var o=n||c||l,f=i||a||"";if(!o)return r;if(!Ge.test(o)||ze.test(o))return"url(".concat(f).concat(o).concat(f,")");if(o[0]==="/")return"url(".concat(f).concat(He(t)+o).concat(f,")");var u=t.split("/"),p=o.split("/");u.pop();for(var b=0,w=p;b<w.length;b++){var k=w[b];k!=="."&&(k===".."?u.pop():u.push(k))}return"url(".concat(f).concat(u.join("/")).concat(f,")")})}var je=/^[^ \t\n\r\u000c]+/,Ke=/^[, \t\n\r\u000c]+/;function Be(e,t){if(t.trim()==="")return t;var r=0;function i(f){var u,p=f.exec(t.substring(r));return p?(u=p[0],r+=u.length,u):""}for(var n=[];i(Ke),!(r>=t.length);){var a=i(je);if(a.slice(-1)===",")a=j(e,a.substring(0,a.length-1)),n.push(a);else{var c="";a=j(e,a);for(var l=!1;;){var o=t.charAt(r);if(o===""){n.push((a+c).trim());break}else if(l)o===")"&&(l=!1);else if(o===","){r+=1,n.push((a+c).trim());break}else o==="("&&(l=!0);c+=o,r+=1}}}return n.join(", ")}function j(e,t){if(!t||t.trim()==="")return t;var r=e.createElement("a");return r.href=t,r.href}function Qe(e){return!!(e.tagName==="svg"||e.ownerSVGElement)}function ie(){var e=document.createElement("a");return e.href="",e.href}function $e(e,t,r,i){return r==="src"||r==="href"&&i&&!(t==="use"&&i[0]==="#")||r==="xlink:href"&&i&&i[0]!=="#"||r==="background"&&i&&(t==="table"||t==="td"||t==="th")?j(e,i):r==="srcset"&&i?Be(e,i):r==="style"&&i?$(i,ie()):t==="object"&&r==="data"&&i?j(e,i):i}function qe(e,t,r){if(typeof t=="string"){if(e.classList.contains(t))return!0}else for(var i=e.classList.length;i--;){var n=e.classList[i];if(t.test(n))return!0}return r?e.matches(r):!1}function re(e,t,r){if(!e)return!1;if(e.nodeType!==e.ELEMENT_NODE)return r?re(e.parentNode,t,r):!1;for(var i=e.classList.length;i--;){var n=e.classList[i];if(t.test(n))return!0}return r?re(e.parentNode,t,r):!1}function Je(e,t,r){var i=e.nodeType===e.ELEMENT_NODE?e:e.parentElement;if(i===null)return!1;if(typeof t=="string"){if(i.classList.contains(t)||i.closest(".".concat(t)))return!0}else if(re(i,t,!0))return!0;return!!(r&&(i.matches(r)||i.closest(r)))}function Ye(e,t,r){var i=e.contentWindow;if(i){var n=!1,a;try{a=i.document.readyState}catch{return}if(a!=="complete"){var c=setTimeout(function(){n||(t(),n=!0)},r);e.addEventListener("load",function(){clearTimeout(c),n=!0,t()});return}var l="about:blank";if(i.location.href!==l||e.src===l||e.src==="")return setTimeout(t,0),e.addEventListener("load",t);e.addEventListener("load",t)}}function Ve(e,t,r){var i=!1,n;try{n=e.sheet}catch{return}if(!n){var a=setTimeout(function(){i||(t(),i=!0)},r);e.addEventListener("load",function(){clearTimeout(a),i=!0,t()})}}function Xe(e,t){var r=t.doc,i=t.mirror,n=t.blockClass,a=t.blockSelector,c=t.maskTextClass,l=t.maskTextSelector,o=t.inlineStylesheet,f=t.maskInputOptions,u=f===void 0?{}:f,p=t.maskTextFn,b=t.maskInputFn,w=t.dataURLOptions,k=w===void 0?{}:w,I=t.inlineImages,T=t.recordCanvas,x=t.keepIframeSrcFn,h=t.newlyAddedElement,s=h===void 0?!1:h,y=Ze(r,i);switch(e.nodeType){case e.DOCUMENT_NODE:return e.compatMode!=="CSS1Compat"?{type:g.Document,childNodes:[],compatMode:e.compatMode}:{type:g.Document,childNodes:[]};case e.DOCUMENT_TYPE_NODE:return{type:g.DocumentType,name:e.name,publicId:e.publicId,systemId:e.systemId,rootId:y};case e.ELEMENT_NODE:return tt(e,{doc:r,blockClass:n,blockSelector:a,inlineStylesheet:o,maskInputOptions:u,maskInputFn:b,dataURLOptions:k,inlineImages:I,recordCanvas:T,keepIframeSrcFn:x,newlyAddedElement:s,rootId:y});case e.TEXT_NODE:return et(e,{maskTextClass:c,maskTextSelector:l,maskTextFn:p,rootId:y});case e.CDATA_SECTION_NODE:return{type:g.CDATA,textContent:"",rootId:y};case e.COMMENT_NODE:return{type:g.Comment,textContent:e.textContent||"",rootId:y};default:return!1}}function Ze(e,t){if(t.hasNode(e)){var r=t.getId(e);return r===1?void 0:r}}function et(e,t){var r,i=t.maskTextClass,n=t.maskTextSelector,a=t.maskTextFn,c=t.rootId,l=e.parentNode&&e.parentNode.tagName,o=e.textContent,f=l==="STYLE"?!0:void 0,u=l==="SCRIPT"?!0:void 0;if(f&&o){try{e.nextSibling||e.previousSibling||!((r=e.parentNode.sheet)===null||r===void 0)&&r.cssRules&&(o=Ue(e.parentNode.sheet))}catch(p){console.warn("Cannot get CSS styles from text's parentNode. Error: ".concat(p),e)}o=$(o,ie())}return u&&(o="SCRIPT_PLACEHOLDER"),!f&&!u&&o&&Je(e,i,n)&&(o=a?a(o):o.replace(/[\S]/g,"*")),{type:g.Text,textContent:o||"",isStyle:f,rootId:c}}function tt(e,t){for(var r=t.doc,i=t.blockClass,n=t.blockSelector,a=t.inlineStylesheet,c=t.maskInputOptions,l=c===void 0?{}:c,o=t.maskInputFn,f=t.dataURLOptions,u=f===void 0?{}:f,p=t.inlineImages,b=t.recordCanvas,w=t.keepIframeSrcFn,k=t.newlyAddedElement,I=k===void 0?!1:k,T=t.rootId,x=qe(e,i,n),h=Pe(e),s={},y=e.attributes.length,M=0;M<y;M++){var E=e.attributes[M];s[E.name]=$e(r,h,E.name,E.value)}if(h==="link"&&a){var C=Array.from(r.styleSheets).find(function(N){return N.href===e.href}),m=null;C&&(m=te(C)),m&&(delete s.rel,delete s.href,s._cssText=$(m,C.href))}if(h==="style"&&e.sheet&&!(e.innerText||e.textContent||"").trim().length){var m=te(e.sheet);m&&(s._cssText=$(m,ie()))}if(h==="input"||h==="textarea"||h==="select"){var P=e.value,_=e.checked;s.type!=="radio"&&s.type!=="checkbox"&&s.type!=="submit"&&s.type!=="button"&&P?s.value=Oe({type:s.type,tagName:h,value:P,maskInputOptions:l,maskInputFn:o}):_&&(s.checked=_)}if(h==="option"&&(e.selected&&!l.select?s.selected=!0:delete s.selected),h==="canvas"&&b){if(e.__context==="2d")Me(e)||(s.rr_dataURL=e.toDataURL(u.type,u.quality));else if(!("__context"in e)){var L=e.toDataURL(u.type,u.quality),D=document.createElement("canvas");D.width=e.width,D.height=e.height;var A=D.toDataURL(u.type,u.quality);L!==A&&(s.rr_dataURL=L)}}if(h==="img"&&p){z||(z=r.createElement("canvas"),fe=z.getContext("2d"));var S=e,R=S.crossOrigin;S.crossOrigin="anonymous";var F=function(){try{z.width=S.naturalWidth,z.height=S.naturalHeight,fe.drawImage(S,0,0),s.rr_dataURL=z.toDataURL(u.type,u.quality)}catch(N){console.warn("Cannot inline img src=".concat(S.currentSrc,"! Error: ").concat(N))}R?s.crossOrigin=R:S.removeAttribute("crossorigin")};S.complete&&S.naturalWidth!==0?F():S.onload=F}if((h==="audio"||h==="video")&&(s.rr_mediaState=e.paused?"paused":"played",s.rr_mediaCurrentTime=e.currentTime),I||(e.scrollLeft&&(s.rr_scrollLeft=e.scrollLeft),e.scrollTop&&(s.rr_scrollTop=e.scrollTop)),x){var U=e.getBoundingClientRect(),H=U.width,O=U.height;s={class:s.class,rr_width:"".concat(H,"px"),rr_height:"".concat(O,"px")}}return h==="iframe"&&!w(s.src)&&(e.contentDocument||(s.rr_src=s.src),delete s.src),{type:g.Element,tagName:h,attributes:s,childNodes:[],isSVG:Qe(e)||void 0,needBlock:x,rootId:T}}function d(e){return e===void 0?"":e.toLowerCase()}function rt(e,t){if(t.comment&&e.type===g.Comment)return!0;if(e.type===g.Element){if(t.script&&(e.tagName==="script"||e.tagName==="link"&&e.attributes.rel==="preload"&&e.attributes.as==="script"||e.tagName==="link"&&e.attributes.rel==="prefetch"&&typeof e.attributes.href=="string"&&e.attributes.href.endsWith(".js")))return!0;if(t.headFavicon&&(e.tagName==="link"&&e.attributes.rel==="shortcut icon"||e.tagName==="meta"&&(d(e.attributes.name).match(/^msapplication-tile(image|color)$/)||d(e.attributes.name)==="application-name"||d(e.attributes.rel)==="icon"||d(e.attributes.rel)==="apple-touch-icon"||d(e.attributes.rel)==="shortcut icon")))return!0;if(e.tagName==="meta"){if(t.headMetaDescKeywords&&d(e.attributes.name).match(/^description|keywords$/))return!0;if(t.headMetaSocial&&(d(e.attributes.property).match(/^(og|twitter|fb):/)||d(e.attributes.name).match(/^(og|twitter):/)||d(e.attributes.name)==="pinterest"))return!0;if(t.headMetaRobots&&(d(e.attributes.name)==="robots"||d(e.attributes.name)==="googlebot"||d(e.attributes.name)==="bingbot"))return!0;if(t.headMetaHttpEquiv&&e.attributes["http-equiv"]!==void 0)return!0;if(t.headMetaAuthorship&&(d(e.attributes.name)==="author"||d(e.attributes.name)==="generator"||d(e.attributes.name)==="framework"||d(e.attributes.name)==="publisher"||d(e.attributes.name)==="progid"||d(e.attributes.property).match(/^article:/)||d(e.attributes.property).match(/^product:/)))return!0;if(t.headMetaVerification&&(d(e.attributes.name)==="google-site-verification"||d(e.attributes.name)==="yandex-verification"||d(e.attributes.name)==="csrf-token"||d(e.attributes.name)==="p:domain_verify"||d(e.attributes.name)==="verify-v1"||d(e.attributes.name)==="verification"||d(e.attributes.name)==="shopify-checkout-api-token"))return!0}}return!1}function Q(e,t){var r=t.doc,i=t.mirror,n=t.blockClass,a=t.blockSelector,c=t.maskTextClass,l=t.maskTextSelector,o=t.skipChild,f=o===void 0?!1:o,u=t.inlineStylesheet,p=u===void 0?!0:u,b=t.maskInputOptions,w=b===void 0?{}:b,k=t.maskTextFn,I=t.maskInputFn,T=t.slimDOMOptions,x=t.dataURLOptions,h=x===void 0?{}:x,s=t.inlineImages,y=s===void 0?!1:s,M=t.recordCanvas,E=M===void 0?!1:M,C=t.onSerialize,m=t.onIframeLoad,P=t.iframeLoadTimeout,_=P===void 0?5e3:P,L=t.onStylesheetLoad,D=t.stylesheetLoadTimeout,A=D===void 0?5e3:D,S=t.keepIframeSrcFn,R=S===void 0?function(){return!1}:S,F=t.newlyAddedElement,U=F===void 0?!1:F,H=t.preserveWhiteSpace,O=H===void 0?!0:H,N=Xe(e,{doc:r,mirror:i,blockClass:n,blockSelector:a,maskTextClass:c,maskTextSelector:l,inlineStylesheet:p,maskInputOptions:w,maskTextFn:k,maskInputFn:I,dataURLOptions:h,inlineImages:y,recordCanvas:E,keepIframeSrcFn:R,newlyAddedElement:U});if(!N)return console.warn(e,"not serialized"),null;var B;i.hasNode(e)?B=i.getId(e):rt(N,T)||!O&&N.type===g.Text&&!N.isStyle&&!N.textContent.replace(/^\s+|\s+$/gm,"").length?B=le:B=Fe();var v=Object.assign(N,{id:B});if(i.add(e,v),B===le)return null;C&&C(e);var J=!f;if(v.type===g.Element){J=J&&!v.needBlock,delete v.needBlock;var ne=e.shadowRoot;ne&&ee(ne)&&(v.isShadowHost=!0)}if((v.type===g.Document||v.type===g.Element)&&J){T.headWhitespace&&v.type===g.Element&&v.tagName==="head"&&(O=!1);for(var ae={doc:r,mirror:i,blockClass:n,blockSelector:a,maskTextClass:c,maskTextSelector:l,skipChild:f,inlineStylesheet:p,maskInputOptions:w,maskTextFn:k,maskInputFn:I,slimDOMOptions:T,dataURLOptions:h,inlineImages:y,recordCanvas:E,preserveWhiteSpace:O,onSerialize:C,onIframeLoad:m,iframeLoadTimeout:_,onStylesheetLoad:L,stylesheetLoadTimeout:A,keepIframeSrcFn:R},Y=0,oe=Array.from(e.childNodes);Y<oe.length;Y++){var V=oe[Y],W=Q(V,ae);W&&v.childNodes.push(W)}if(xe(e)&&e.shadowRoot)for(var X=0,se=Array.from(e.shadowRoot.childNodes);X<se.length;X++){var V=se[X],W=Q(V,ae);W&&(ee(e.shadowRoot)&&(W.isShadow=!0),v.childNodes.push(W))}}return e.parentNode&&Ee(e.parentNode)&&ee(e.parentNode)&&(v.isShadow=!0),v.type===g.Element&&v.tagName==="iframe"&&Ye(e,function(){var G=e.contentDocument;if(G&&m){var ce=Q(G,{doc:G,mirror:i,blockClass:n,blockSelector:a,maskTextClass:c,maskTextSelector:l,skipChild:!1,inlineStylesheet:p,maskInputOptions:w,maskTextFn:k,maskInputFn:I,slimDOMOptions:T,dataURLOptions:h,inlineImages:y,recordCanvas:E,preserveWhiteSpace:O,onSerialize:C,onIframeLoad:m,iframeLoadTimeout:_,onStylesheetLoad:L,stylesheetLoadTimeout:A,keepIframeSrcFn:R});ce&&m(e,ce)}},_),v.type===g.Element&&v.tagName==="link"&&v.attributes.rel==="stylesheet"&&Ve(e,function(){if(L){var G=Q(e,{doc:r,mirror:i,blockClass:n,blockSelector:a,maskTextClass:c,maskTextSelector:l,skipChild:!1,inlineStylesheet:p,maskInputOptions:w,maskTextFn:k,maskInputFn:I,slimDOMOptions:T,dataURLOptions:h,inlineImages:y,recordCanvas:E,preserveWhiteSpace:O,onSerialize:C,onIframeLoad:m,iframeLoadTimeout:_,onStylesheetLoad:L,stylesheetLoadTimeout:A,keepIframeSrcFn:R});G&&L(e,G)}},A),v}function de(e,t){var r=t||{},i=r.mirror,n=i===void 0?new Re:i,a=r.blockClass,c=a===void 0?"rr-block":a,l=r.blockSelector,o=l===void 0?null:l,f=r.maskTextClass,u=f===void 0?"rr-mask":f,p=r.maskTextSelector,b=p===void 0?null:p,w=r.inlineStylesheet,k=w===void 0?!0:w,I=r.inlineImages,T=I===void 0?!1:I,x=r.recordCanvas,h=x===void 0?!1:x,s=r.maskAllInputs,y=s===void 0?!1:s,M=r.maskTextFn,E=r.maskInputFn,C=r.slimDOM,m=C===void 0?!1:C,P=r.dataURLOptions,_=r.preserveWhiteSpace,L=r.onSerialize,D=r.onIframeLoad,A=r.iframeLoadTimeout,S=r.onStylesheetLoad,R=r.stylesheetLoadTimeout,F=r.keepIframeSrcFn,U=F===void 0?function(){return!1}:F,H=y===!0?{color:!0,date:!0,"datetime-local":!0,email:!0,month:!0,number:!0,range:!0,search:!0,tel:!0,text:!0,time:!0,url:!0,week:!0,textarea:!0,select:!0,password:!0}:y===!1?{password:!0}:y,O=m===!0||m==="all"?{script:!0,comment:!0,headFavicon:!0,headWhitespace:!0,headMetaDescKeywords:m==="all",headMetaSocial:!0,headMetaRobots:!0,headMetaHttpEquiv:!0,headMetaAuthorship:!0,headMetaVerification:!0}:m===!1?{}:m;return Q(e,{doc:e,mirror:n,blockClass:c,blockSelector:o,maskTextClass:u,maskTextSelector:b,skipChild:!1,inlineStylesheet:k,maskInputOptions:H,maskTextFn:M,maskInputFn:E,slimDOMOptions:O,dataURLOptions:P,inlineImages:T,recordCanvas:h,preserveWhiteSpace:_,onSerialize:L,onIframeLoad:D,iframeLoadTimeout:A,onStylesheetLoad:S,stylesheetLoadTimeout:R,keepIframeSrcFn:U,newlyAddedElement:!1})}var it=/([^\\]):hover/,st=new RegExp(it.source,"g");function q(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return(e==="x"?t:t&3|8).toString(16)})}function he(){let e="_krypton_sid";if(typeof sessionStorage<"u"){let t=sessionStorage.getItem(e);return t||(t=q(),sessionStorage.setItem(e,t)),t}return q()}function pe(){let e="_krypton_did";if(typeof localStorage<"u"){let t=localStorage.getItem(e);return t||(t=q(),localStorage.setItem(e,t)),t}return q()}function me(){if(typeof window>"u")return{};let e=new URLSearchParams(window.location.search),t={};for(let r of["utm_source","utm_medium","utm_campaign","utm_term","utm_content"]){let i=e.get(r);i&&(t[r]=i)}return t}function ve(){if(typeof window>"u")return"unknown";let e=window.innerWidth;return e<768?"mobile":e<1024?"tablet":"desktop"}function ge(e){if(e.id)return`#${e.id}`;let t=[],r=e;for(;r&&r!==document.body;){let i=r.tagName.toLowerCase();if(r.id){t.unshift(`#${r.id}`);break}if(r.className&&typeof r.className=="string"){let n=r.className.trim().split(/\s+/).slice(0,2).join(".");n&&(i+=`.${n}`)}t.unshift(i),r=r.parentElement}return t.join(" > ")}var K=class{constructor(t){this.eventQueue=[];this.heatmapQueue=[];this.flushTimer=null;this.consentGiven=!1;this.initialized=!1;this.lastSnapshotUrl=null;this.serverConfig=null;this.configFetched=!1;this.config={autoPageview:!0,heatmap:!1,consentRequired:!1,flushInterval:5e3,batchSize:20,...t},this.distinctId=pe(),this.sessionId=he(),this.config.consentRequired||(this.consentGiven=!0),this.init()}init(){this.initialized||(this.initialized=!0,this.fetchConfig().then(()=>this.setupTracking()))}async fetchConfig(){if(typeof window>"u")return;let t=`_krypton_config_${this.config.apiKey}`,r=sessionStorage.getItem(t);if(r)try{let i=JSON.parse(r);if(i._ts&&Date.now()-i._ts<300*1e3){this.serverConfig=i,this.configFetched=!0;return}}catch{}try{let i=await fetch(`${this.config.endpoint}/api/v1/config?api_key=${encodeURIComponent(this.config.apiKey)}`);if(i.ok){let n=await i.json();this.serverConfig=n,this.configFetched=!0,sessionStorage.setItem(t,JSON.stringify({...n,_ts:Date.now()}))}}catch{}}setupTracking(){if(this.flushTimer=setInterval(()=>this.flush(),this.config.flushInterval),typeof window<"u"){window.addEventListener("beforeunload",()=>this.flush()),this.config.autoPageview&&this.consentGiven&&this.trackPageview();let t=this.config.heatmap&&(!this.configFetched||this.serverConfig?.heatmaps_enabled),r=history.pushState;history.pushState=(...i)=>{r.apply(history,i),this.config.autoPageview&&this.consentGiven&&setTimeout(()=>this.trackPageview(),0),t&&this.consentGiven&&setTimeout(()=>this.captureSnapshot(),0)},window.addEventListener("popstate",()=>{this.config.autoPageview&&this.consentGiven&&setTimeout(()=>this.trackPageview(),0),t&&this.consentGiven&&setTimeout(()=>this.captureSnapshot(),0)}),t&&this.consentGiven&&this.setupHeatmap()}}grantConsent(){this.consentGiven=!0,this.config.autoPageview&&this.trackPageview(),this.config.heatmap&&(!this.configFetched||this.serverConfig?.heatmaps_enabled)&&this.setupHeatmap()}revokeConsent(){this.consentGiven=!1,this.eventQueue=[],this.heatmapQueue=[]}identify(t){this.distinctId=t,typeof localStorage<"u"&&localStorage.setItem("_krypton_did",t)}trackPageview(t){this.consentGiven&&this.track("$pageview",{...t})}track(t,r){if(!this.consentGiven)return;let i=me(),n={project_id:this.config.apiKey,distinct_id:this.distinctId,event_name:t,timestamp:new Date().toISOString(),properties:r,page_url:typeof window<"u"?window.location.href:"",page_title:typeof document<"u"?document.title:"",referrer:typeof document<"u"?document.referrer:"",utm_source:i.utm_source||"",utm_medium:i.utm_medium||"",utm_campaign:i.utm_campaign||"",utm_term:i.utm_term||"",utm_content:i.utm_content||"",device_type:ve(),browser:this.getBrowser(),screen_width:typeof window<"u"?window.screen.width:0,screen_height:typeof window<"u"?window.screen.height:0,session_id:this.sessionId};this.eventQueue.push(n),this.eventQueue.length>=this.config.batchSize&&this.flush()}async flush(){await Promise.all([this.flushEvents(),this.flushHeatmapEvents()])}shutdown(){this.flushTimer&&(clearInterval(this.flushTimer),this.flushTimer=null),this.flush()}async flushEvents(){if(this.eventQueue.length===0)return;let t=this.eventQueue.splice(0,this.eventQueue.length),r={api_key:this.config.apiKey,events:t};try{await fetch(`${this.config.endpoint}/api/v1/ingest/batch`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(r),keepalive:!0})}catch{this.eventQueue.length<this.config.batchSize*5&&this.eventQueue.unshift(...t)}}async flushHeatmapEvents(){if(this.heatmapQueue.length===0)return;let t=this.heatmapQueue.splice(0,this.heatmapQueue.length),r={api_key:this.config.apiKey,events:t};try{await fetch(`${this.config.endpoint}/api/v1/heatmap`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(r),keepalive:!0})}catch{this.heatmapQueue.length<this.config.batchSize*5&&this.heatmapQueue.unshift(...t)}}captureSnapshot(){if(typeof window>"u"||typeof document>"u")return;let t=window.location.href;this.lastSnapshotUrl!==t&&(this.lastSnapshotUrl=t,setTimeout(()=>{try{let r=de(document,{maskAllInputs:!0,blockSelector:"[data-krypton-block]",inlineStylesheet:!0});if(!r)return;let i=JSON.stringify(r),n={api_key:this.config.apiKey,page_url:t,snapshot:i,viewport_width:window.innerWidth,viewport_height:window.innerHeight,page_width:document.documentElement.scrollWidth,page_height:document.documentElement.scrollHeight,timestamp:new Date().toISOString()};fetch(`${this.config.endpoint}/api/v1/snapshot`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(n),keepalive:!0}).catch(()=>{})}catch{}},1e3))}setupHeatmap(){if(typeof window>"u")return;this.captureSnapshot(),document.addEventListener("click",i=>{if(!this.consentGiven)return;let n=i.target;this.heatmapQueue.push({project_id:this.config.apiKey,distinct_id:this.distinctId,session_id:this.sessionId,timestamp:new Date().toISOString(),page_url:window.location.href,interaction_type:"click",x:i.clientX+window.scrollX,y:i.clientY+window.scrollY,viewport_width:window.innerWidth,viewport_height:window.innerHeight,page_width:document.documentElement.scrollWidth,page_height:document.documentElement.scrollHeight,selector:ge(n)})});let t=0,r=null;window.addEventListener("scroll",()=>{if(!this.consentGiven)return;let i=window.scrollY||document.documentElement.scrollTop,n=document.documentElement.scrollHeight-window.innerHeight,a=n>0?i/n*100:0;a>t&&(t=a),r&&clearTimeout(r),r=setTimeout(()=>{this.heatmapQueue.push({project_id:this.config.apiKey,distinct_id:this.distinctId,session_id:this.sessionId,timestamp:new Date().toISOString(),page_url:window.location.href,interaction_type:"scroll",scroll_depth:t,viewport_width:window.innerWidth,viewport_height:window.innerHeight,page_width:document.documentElement.scrollWidth,page_height:document.documentElement.scrollHeight})},500)})}getBrowser(){if(typeof navigator>"u")return"unknown";let t=navigator.userAgent;return t.includes("Firefox")?"Firefox":t.includes("Edg")?"Edge":t.includes("Chrome")?"Chrome":t.includes("Safari")?"Safari":"Other"}};function ye(e){return new K(e)}var we={Krypton:K,init:ye};typeof window<"u"&&(window.KryptonAnalytics=we);var nt=we;return Te(at);})();
+"use strict";var KryptonAnalytics=(()=>{var Z=Object.defineProperty;var we=Object.getOwnPropertyDescriptor;var Se=Object.getOwnPropertyNames;var be=Object.prototype.hasOwnProperty;var Ce=(e,t)=>{for(var r in t)Z(e,r,{get:t[r],enumerable:!0})},xe=(e,t,r,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of Se(t))!be.call(e,n)&&n!==r&&Z(e,n,{get:()=>t[n],enumerable:!(i=we(t,n))||i.enumerable});return e};var Ie=e=>xe(Z({},"__esModule",{value:!0}),e);var at={};Ce(at,{Krypton:()=>q,default:()=>nt,init:()=>ye});var v;(function(e){e[e.Document=0]="Document",e[e.DocumentType=1]="DocumentType",e[e.Element=2]="Element",e[e.Text=3]="Text",e[e.CDATA=4]="CDATA",e[e.Comment=5]="Comment"})(v||(v={}));function Te(e){return e.nodeType===e.ELEMENT_NODE}function Ee(e){var t=e?.host;return t?.shadowRoot===e}function ee(e){return Object.prototype.toString.call(e)==="[object ShadowRoot]"}function Le(e){return e.includes(" background-clip: text;")&&!e.includes(" -webkit-background-clip: text;")&&(e=e.replace(" background-clip: text;"," -webkit-background-clip: text; background-clip: text;")),e}function te(e){try{var t=e.rules||e.cssRules;return t?Le(Array.from(t).map(Re).join("")):null}catch{return null}}function Re(e){var t=e.cssText;if(_e(e))try{t=te(e.styleSheet)||t}catch{}return t}function _e(e){return"styleSheet"in e}var Ne=(function(){function e(){this.idNodeMap=new Map,this.nodeMetaMap=new WeakMap}return e.prototype.getId=function(t){var r;if(!t)return-1;var i=(r=this.getMeta(t))===null||r===void 0?void 0:r.id;return i??-1},e.prototype.getNode=function(t){return this.idNodeMap.get(t)||null},e.prototype.getIds=function(){return Array.from(this.idNodeMap.keys())},e.prototype.getMeta=function(t){return this.nodeMetaMap.get(t)||null},e.prototype.removeNodeFromMap=function(t){var r=this,i=this.getId(t);this.idNodeMap.delete(i),t.childNodes&&t.childNodes.forEach(function(n){return r.removeNodeFromMap(n)})},e.prototype.has=function(t){return this.idNodeMap.has(t)},e.prototype.hasNode=function(t){return this.nodeMetaMap.has(t)},e.prototype.add=function(t,r){var i=r.id;this.idNodeMap.set(i,t),this.nodeMetaMap.set(t,r)},e.prototype.replace=function(t,r){var i=this.getNode(t);if(i){var n=this.nodeMetaMap.get(i);n&&this.nodeMetaMap.set(r,n)}this.idNodeMap.set(t,r)},e.prototype.reset=function(){this.idNodeMap=new Map,this.nodeMetaMap=new WeakMap},e})();function Oe(e){var t=e.maskInputOptions,r=e.tagName,i=e.type,n=e.value,a=e.maskInputFn,c=n||"";return(t[r.toLowerCase()]||t[i])&&(a?c=a(c):c="*".repeat(c.length)),c}var le="__rrweb_original__";function Me(e){var t=e.getContext("2d");if(!t)return!0;for(var r=50,i=0;i<e.width;i+=r)for(var n=0;n<e.height;n+=r){var a=t.getImageData,c=le in a?a[le]:a,u=new Uint32Array(c.call(t,i,n,Math.min(r,e.width-i),Math.min(r,e.height-n)).data.buffer);if(u.some(function(o){return o!==0}))return!1}return!0}var Ae=1,De=new RegExp("[^a-z0-9-_:]"),ue=-2;function Fe(){return Ae++}function Pe(e){if(e instanceof HTMLFormElement)return"form";var t=e.tagName.toLowerCase().trim();return De.test(t)?"div":t}function He(e){return e.cssRules?Array.from(e.cssRules).map(function(t){return t.cssText||""}).join(""):""}function Ue(e){var t="";return e.indexOf("//")>-1?t=e.split("/").slice(0,3).join("/"):t=e.split("/")[0],t=t.split("?")[0],t}var z,fe,We=/url\((?:(')([^']*)'|(")(.*?)"|([^)]*))\)/gm,Ke=/^(?!www\.|(?:http|ftp)s?:\/\/|[A-Za-z]:\\|\/\/|#).*/,Be=/^(data:)([^,]*),(.*)/i;function $(e,t){return(e||"").replace(We,function(r,i,n,a,c,u){var o=n||c||u,f=i||a||"";if(!o)return r;if(!Ke.test(o)||Be.test(o))return"url(".concat(f).concat(o).concat(f,")");if(o[0]==="/")return"url(".concat(f).concat(Ue(t)+o).concat(f,")");var l=t.split("/"),h=o.split("/");l.pop();for(var b=0,k=h;b<k.length;b++){var w=k[b];w!=="."&&(w===".."?l.pop():l.push(w))}return"url(".concat(f).concat(l.join("/")).concat(f,")")})}var ze=/^[^ \t\n\r\u000c]+/,je=/^[, \t\n\r\u000c]+/;function qe(e,t){if(t.trim()==="")return t;var r=0;function i(f){var l,h=f.exec(t.substring(r));return h?(l=h[0],r+=l.length,l):""}for(var n=[];i(je),!(r>=t.length);){var a=i(ze);if(a.slice(-1)===",")a=j(e,a.substring(0,a.length-1)),n.push(a);else{var c="";a=j(e,a);for(var u=!1;;){var o=t.charAt(r);if(o===""){n.push((a+c).trim());break}else if(u)o===")"&&(u=!1);else if(o===","){r+=1,n.push((a+c).trim());break}else o==="("&&(u=!0);c+=o,r+=1}}}return n.join(", ")}function j(e,t){if(!t||t.trim()==="")return t;var r=e.createElement("a");return r.href=t,r.href}function Ge(e){return!!(e.tagName==="svg"||e.ownerSVGElement)}function ie(){var e=document.createElement("a");return e.href="",e.href}function Qe(e,t,r,i){return r==="src"||r==="href"&&i&&!(t==="use"&&i[0]==="#")||r==="xlink:href"&&i&&i[0]!=="#"||r==="background"&&i&&(t==="table"||t==="td"||t==="th")?j(e,i):r==="srcset"&&i?qe(e,i):r==="style"&&i?$(i,ie()):t==="object"&&r==="data"&&i?j(e,i):i}function $e(e,t,r){if(typeof t=="string"){if(e.classList.contains(t))return!0}else for(var i=e.classList.length;i--;){var n=e.classList[i];if(t.test(n))return!0}return r?e.matches(r):!1}function re(e,t,r){if(!e)return!1;if(e.nodeType!==e.ELEMENT_NODE)return r?re(e.parentNode,t,r):!1;for(var i=e.classList.length;i--;){var n=e.classList[i];if(t.test(n))return!0}return r?re(e.parentNode,t,r):!1}function Je(e,t,r){var i=e.nodeType===e.ELEMENT_NODE?e:e.parentElement;if(i===null)return!1;if(typeof t=="string"){if(i.classList.contains(t)||i.closest(".".concat(t)))return!0}else if(re(i,t,!0))return!0;return!!(r&&(i.matches(r)||i.closest(r)))}function Ve(e,t,r){var i=e.contentWindow;if(i){var n=!1,a;try{a=i.document.readyState}catch{return}if(a!=="complete"){var c=setTimeout(function(){n||(t(),n=!0)},r);e.addEventListener("load",function(){clearTimeout(c),n=!0,t()});return}var u="about:blank";if(i.location.href!==u||e.src===u||e.src==="")return setTimeout(t,0),e.addEventListener("load",t);e.addEventListener("load",t)}}function Ye(e,t,r){var i=!1,n;try{n=e.sheet}catch{return}if(!n){var a=setTimeout(function(){i||(t(),i=!0)},r);e.addEventListener("load",function(){clearTimeout(a),i=!0,t()})}}function Xe(e,t){var r=t.doc,i=t.mirror,n=t.blockClass,a=t.blockSelector,c=t.maskTextClass,u=t.maskTextSelector,o=t.inlineStylesheet,f=t.maskInputOptions,l=f===void 0?{}:f,h=t.maskTextFn,b=t.maskInputFn,k=t.dataURLOptions,w=k===void 0?{}:k,x=t.inlineImages,I=t.recordCanvas,T=t.keepIframeSrcFn,p=t.newlyAddedElement,s=p===void 0?!1:p,y=Ze(r,i);switch(e.nodeType){case e.DOCUMENT_NODE:return e.compatMode!=="CSS1Compat"?{type:v.Document,childNodes:[],compatMode:e.compatMode}:{type:v.Document,childNodes:[]};case e.DOCUMENT_TYPE_NODE:return{type:v.DocumentType,name:e.name,publicId:e.publicId,systemId:e.systemId,rootId:y};case e.ELEMENT_NODE:return tt(e,{doc:r,blockClass:n,blockSelector:a,inlineStylesheet:o,maskInputOptions:l,maskInputFn:b,dataURLOptions:w,inlineImages:x,recordCanvas:I,keepIframeSrcFn:T,newlyAddedElement:s,rootId:y});case e.TEXT_NODE:return et(e,{maskTextClass:c,maskTextSelector:u,maskTextFn:h,rootId:y});case e.CDATA_SECTION_NODE:return{type:v.CDATA,textContent:"",rootId:y};case e.COMMENT_NODE:return{type:v.Comment,textContent:e.textContent||"",rootId:y};default:return!1}}function Ze(e,t){if(t.hasNode(e)){var r=t.getId(e);return r===1?void 0:r}}function et(e,t){var r,i=t.maskTextClass,n=t.maskTextSelector,a=t.maskTextFn,c=t.rootId,u=e.parentNode&&e.parentNode.tagName,o=e.textContent,f=u==="STYLE"?!0:void 0,l=u==="SCRIPT"?!0:void 0;if(f&&o){try{e.nextSibling||e.previousSibling||!((r=e.parentNode.sheet)===null||r===void 0)&&r.cssRules&&(o=He(e.parentNode.sheet))}catch(h){console.warn("Cannot get CSS styles from text's parentNode. Error: ".concat(h),e)}o=$(o,ie())}return l&&(o="SCRIPT_PLACEHOLDER"),!f&&!l&&o&&Je(e,i,n)&&(o=a?a(o):o.replace(/[\S]/g,"*")),{type:v.Text,textContent:o||"",isStyle:f,rootId:c}}function tt(e,t){for(var r=t.doc,i=t.blockClass,n=t.blockSelector,a=t.inlineStylesheet,c=t.maskInputOptions,u=c===void 0?{}:c,o=t.maskInputFn,f=t.dataURLOptions,l=f===void 0?{}:f,h=t.inlineImages,b=t.recordCanvas,k=t.keepIframeSrcFn,w=t.newlyAddedElement,x=w===void 0?!1:w,I=t.rootId,T=$e(e,i,n),p=Pe(e),s={},y=e.attributes.length,M=0;M<y;M++){var E=e.attributes[M];s[E.name]=Qe(r,p,E.name,E.value)}if(p==="link"&&a){var C=Array.from(r.styleSheets).find(function(R){return R.href===e.href}),m=null;C&&(m=te(C)),m&&(delete s.rel,delete s.href,s._cssText=$(m,C.href))}if(p==="style"&&e.sheet&&!(e.innerText||e.textContent||"").trim().length){var m=te(e.sheet);m&&(s._cssText=$(m,ie()))}if(p==="input"||p==="textarea"||p==="select"){var P=e.value,_=e.checked;s.type!=="radio"&&s.type!=="checkbox"&&s.type!=="submit"&&s.type!=="button"&&P?s.value=Oe({type:s.type,tagName:p,value:P,maskInputOptions:u,maskInputFn:o}):_&&(s.checked=_)}if(p==="option"&&(e.selected&&!u.select?s.selected=!0:delete s.selected),p==="canvas"&&b){if(e.__context==="2d")Me(e)||(s.rr_dataURL=e.toDataURL(l.type,l.quality));else if(!("__context"in e)){var L=e.toDataURL(l.type,l.quality),A=document.createElement("canvas");A.width=e.width,A.height=e.height;var D=A.toDataURL(l.type,l.quality);L!==D&&(s.rr_dataURL=L)}}if(p==="img"&&h){z||(z=r.createElement("canvas"),fe=z.getContext("2d"));var S=e,N=S.crossOrigin;S.crossOrigin="anonymous";var F=function(){try{z.width=S.naturalWidth,z.height=S.naturalHeight,fe.drawImage(S,0,0),s.rr_dataURL=z.toDataURL(l.type,l.quality)}catch(R){console.warn("Cannot inline img src=".concat(S.currentSrc,"! Error: ").concat(R))}N?s.crossOrigin=N:S.removeAttribute("crossorigin")};S.complete&&S.naturalWidth!==0?F():S.onload=F}if((p==="audio"||p==="video")&&(s.rr_mediaState=e.paused?"paused":"played",s.rr_mediaCurrentTime=e.currentTime),x||(e.scrollLeft&&(s.rr_scrollLeft=e.scrollLeft),e.scrollTop&&(s.rr_scrollTop=e.scrollTop)),T){var U=e.getBoundingClientRect(),W=U.width,O=U.height;s={class:s.class,rr_width:"".concat(W,"px"),rr_height:"".concat(O,"px")}}return p==="iframe"&&!k(s.src)&&(e.contentDocument||(s.rr_src=s.src),delete s.src),{type:v.Element,tagName:p,attributes:s,childNodes:[],isSVG:Ge(e)||void 0,needBlock:T,rootId:I}}function d(e){return e===void 0?"":e.toLowerCase()}function rt(e,t){if(t.comment&&e.type===v.Comment)return!0;if(e.type===v.Element){if(t.script&&(e.tagName==="script"||e.tagName==="link"&&e.attributes.rel==="preload"&&e.attributes.as==="script"||e.tagName==="link"&&e.attributes.rel==="prefetch"&&typeof e.attributes.href=="string"&&e.attributes.href.endsWith(".js")))return!0;if(t.headFavicon&&(e.tagName==="link"&&e.attributes.rel==="shortcut icon"||e.tagName==="meta"&&(d(e.attributes.name).match(/^msapplication-tile(image|color)$/)||d(e.attributes.name)==="application-name"||d(e.attributes.rel)==="icon"||d(e.attributes.rel)==="apple-touch-icon"||d(e.attributes.rel)==="shortcut icon")))return!0;if(e.tagName==="meta"){if(t.headMetaDescKeywords&&d(e.attributes.name).match(/^description|keywords$/))return!0;if(t.headMetaSocial&&(d(e.attributes.property).match(/^(og|twitter|fb):/)||d(e.attributes.name).match(/^(og|twitter):/)||d(e.attributes.name)==="pinterest"))return!0;if(t.headMetaRobots&&(d(e.attributes.name)==="robots"||d(e.attributes.name)==="googlebot"||d(e.attributes.name)==="bingbot"))return!0;if(t.headMetaHttpEquiv&&e.attributes["http-equiv"]!==void 0)return!0;if(t.headMetaAuthorship&&(d(e.attributes.name)==="author"||d(e.attributes.name)==="generator"||d(e.attributes.name)==="framework"||d(e.attributes.name)==="publisher"||d(e.attributes.name)==="progid"||d(e.attributes.property).match(/^article:/)||d(e.attributes.property).match(/^product:/)))return!0;if(t.headMetaVerification&&(d(e.attributes.name)==="google-site-verification"||d(e.attributes.name)==="yandex-verification"||d(e.attributes.name)==="csrf-token"||d(e.attributes.name)==="p:domain_verify"||d(e.attributes.name)==="verify-v1"||d(e.attributes.name)==="verification"||d(e.attributes.name)==="shopify-checkout-api-token"))return!0}}return!1}function Q(e,t){var r=t.doc,i=t.mirror,n=t.blockClass,a=t.blockSelector,c=t.maskTextClass,u=t.maskTextSelector,o=t.skipChild,f=o===void 0?!1:o,l=t.inlineStylesheet,h=l===void 0?!0:l,b=t.maskInputOptions,k=b===void 0?{}:b,w=t.maskTextFn,x=t.maskInputFn,I=t.slimDOMOptions,T=t.dataURLOptions,p=T===void 0?{}:T,s=t.inlineImages,y=s===void 0?!1:s,M=t.recordCanvas,E=M===void 0?!1:M,C=t.onSerialize,m=t.onIframeLoad,P=t.iframeLoadTimeout,_=P===void 0?5e3:P,L=t.onStylesheetLoad,A=t.stylesheetLoadTimeout,D=A===void 0?5e3:A,S=t.keepIframeSrcFn,N=S===void 0?function(){return!1}:S,F=t.newlyAddedElement,U=F===void 0?!1:F,W=t.preserveWhiteSpace,O=W===void 0?!0:W,R=Xe(e,{doc:r,mirror:i,blockClass:n,blockSelector:a,maskTextClass:c,maskTextSelector:u,inlineStylesheet:h,maskInputOptions:k,maskTextFn:w,maskInputFn:x,dataURLOptions:p,inlineImages:y,recordCanvas:E,keepIframeSrcFn:N,newlyAddedElement:U});if(!R)return console.warn(e,"not serialized"),null;var G;i.hasNode(e)?G=i.getId(e):rt(R,I)||!O&&R.type===v.Text&&!R.isStyle&&!R.textContent.replace(/^\s+|\s+$/gm,"").length?G=ue:G=Fe();var g=Object.assign(R,{id:G});if(i.add(e,g),G===ue)return null;C&&C(e);var J=!f;if(g.type===v.Element){J=J&&!g.needBlock,delete g.needBlock;var ne=e.shadowRoot;ne&&ee(ne)&&(g.isShadowHost=!0)}if((g.type===v.Document||g.type===v.Element)&&J){I.headWhitespace&&g.type===v.Element&&g.tagName==="head"&&(O=!1);for(var ae={doc:r,mirror:i,blockClass:n,blockSelector:a,maskTextClass:c,maskTextSelector:u,skipChild:f,inlineStylesheet:h,maskInputOptions:k,maskTextFn:w,maskInputFn:x,slimDOMOptions:I,dataURLOptions:p,inlineImages:y,recordCanvas:E,preserveWhiteSpace:O,onSerialize:C,onIframeLoad:m,iframeLoadTimeout:_,onStylesheetLoad:L,stylesheetLoadTimeout:D,keepIframeSrcFn:N},V=0,oe=Array.from(e.childNodes);V<oe.length;V++){var Y=oe[V],K=Q(Y,ae);K&&g.childNodes.push(K)}if(Te(e)&&e.shadowRoot)for(var X=0,se=Array.from(e.shadowRoot.childNodes);X<se.length;X++){var Y=se[X],K=Q(Y,ae);K&&(ee(e.shadowRoot)&&(K.isShadow=!0),g.childNodes.push(K))}}return e.parentNode&&Ee(e.parentNode)&&ee(e.parentNode)&&(g.isShadow=!0),g.type===v.Element&&g.tagName==="iframe"&&Ve(e,function(){var B=e.contentDocument;if(B&&m){var ce=Q(B,{doc:B,mirror:i,blockClass:n,blockSelector:a,maskTextClass:c,maskTextSelector:u,skipChild:!1,inlineStylesheet:h,maskInputOptions:k,maskTextFn:w,maskInputFn:x,slimDOMOptions:I,dataURLOptions:p,inlineImages:y,recordCanvas:E,preserveWhiteSpace:O,onSerialize:C,onIframeLoad:m,iframeLoadTimeout:_,onStylesheetLoad:L,stylesheetLoadTimeout:D,keepIframeSrcFn:N});ce&&m(e,ce)}},_),g.type===v.Element&&g.tagName==="link"&&g.attributes.rel==="stylesheet"&&Ye(e,function(){if(L){var B=Q(e,{doc:r,mirror:i,blockClass:n,blockSelector:a,maskTextClass:c,maskTextSelector:u,skipChild:!1,inlineStylesheet:h,maskInputOptions:k,maskTextFn:w,maskInputFn:x,slimDOMOptions:I,dataURLOptions:p,inlineImages:y,recordCanvas:E,preserveWhiteSpace:O,onSerialize:C,onIframeLoad:m,iframeLoadTimeout:_,onStylesheetLoad:L,stylesheetLoadTimeout:D,keepIframeSrcFn:N});B&&L(e,B)}},D),g}function de(e,t){var r=t||{},i=r.mirror,n=i===void 0?new Ne:i,a=r.blockClass,c=a===void 0?"rr-block":a,u=r.blockSelector,o=u===void 0?null:u,f=r.maskTextClass,l=f===void 0?"rr-mask":f,h=r.maskTextSelector,b=h===void 0?null:h,k=r.inlineStylesheet,w=k===void 0?!0:k,x=r.inlineImages,I=x===void 0?!1:x,T=r.recordCanvas,p=T===void 0?!1:T,s=r.maskAllInputs,y=s===void 0?!1:s,M=r.maskTextFn,E=r.maskInputFn,C=r.slimDOM,m=C===void 0?!1:C,P=r.dataURLOptions,_=r.preserveWhiteSpace,L=r.onSerialize,A=r.onIframeLoad,D=r.iframeLoadTimeout,S=r.onStylesheetLoad,N=r.stylesheetLoadTimeout,F=r.keepIframeSrcFn,U=F===void 0?function(){return!1}:F,W=y===!0?{color:!0,date:!0,"datetime-local":!0,email:!0,month:!0,number:!0,range:!0,search:!0,tel:!0,text:!0,time:!0,url:!0,week:!0,textarea:!0,select:!0,password:!0}:y===!1?{password:!0}:y,O=m===!0||m==="all"?{script:!0,comment:!0,headFavicon:!0,headWhitespace:!0,headMetaDescKeywords:m==="all",headMetaSocial:!0,headMetaRobots:!0,headMetaHttpEquiv:!0,headMetaAuthorship:!0,headMetaVerification:!0}:m===!1?{}:m;return Q(e,{doc:e,mirror:n,blockClass:c,blockSelector:o,maskTextClass:l,maskTextSelector:b,skipChild:!1,inlineStylesheet:w,maskInputOptions:W,maskTextFn:M,maskInputFn:E,slimDOMOptions:O,dataURLOptions:P,inlineImages:I,recordCanvas:p,preserveWhiteSpace:_,onSerialize:L,onIframeLoad:A,iframeLoadTimeout:D,onStylesheetLoad:S,stylesheetLoadTimeout:N,keepIframeSrcFn:U,newlyAddedElement:!1})}var it=/([^\\]):hover/,st=new RegExp(it.source,"g");function H(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return(e==="x"?t:t&3|8).toString(16)})}function pe(){let e="_krypton_sid";try{if(typeof sessionStorage<"u"){let t=sessionStorage.getItem(e);return t||(t=H(),sessionStorage.setItem(e,t)),t}}catch{}return H()}function he(){let e="_krypton_did";try{if(typeof localStorage<"u"){let t=localStorage.getItem(e);return t||(t=H(),localStorage.setItem(e,t)),t}}catch{}return H()}function me(){if(typeof window>"u")return{};let e=new URLSearchParams(window.location.search),t={};for(let r of["utm_source","utm_medium","utm_campaign","utm_term","utm_content"]){let i=e.get(r);i&&(t[r]=i)}return t}function ge(){if(typeof window>"u")return"unknown";let e=window.innerWidth;return e<768?"mobile":e<1024?"tablet":"desktop"}function ve(e){if(e.id)return`#${e.id}`;let t=[],r=e;for(;r&&r!==document.body;){let i=r.tagName.toLowerCase();if(r.id){t.unshift(`#${r.id}`);break}if(r.className&&typeof r.className=="string"){let n=r.className.trim().split(/\s+/).slice(0,2).join(".");n&&(i+=`.${n}`)}t.unshift(i),r=r.parentElement}return t.join(" > ")}var q=class{constructor(t){this.eventQueue=[];this.heatmapQueue=[];this.flushTimer=null;this.initialized=!1;this.lastSnapshotUrl=null;this.heatmapSetup=!1;this.geoRequested=!1;this.geoContext=null;this.serverConfig=null;this.configFetched=!1;this.config={autoPageview:!0,heatmap:!1,consentRequired:!1,showConsentBanner:!1,consentCategories:{},flushInterval:5e3,batchSize:20,...t},this.distinctId=H(),this.sessionId=H(),this.consent=this.resolveInitialConsent(),this.canTrackAnalytics()&&this.promotePersistentIds(),this.init()}init(){this.initialized||(this.initialized=!0,this.fetchConfig().then(()=>{this.setupTracking(),this.config.consentRequired&&this.config.showConsentBanner&&!this.hasStoredConsent()&&this.showConsentBanner()}))}resolveInitialConsent(){let t=this.loadStoredConsent();return t||{...this.config.consentRequired?{analytics:!1,heatmaps:!1,geo:!1}:{analytics:!0,heatmaps:!!this.config.heatmap,geo:!1},...this.config.consentCategories}}consentStorageKey(){return`_krypton_consent_${this.config.apiKey}`}hasStoredConsent(){try{return typeof localStorage>"u"?!1:!!localStorage.getItem(this.consentStorageKey())}catch{return!1}}loadStoredConsent(){try{if(typeof localStorage>"u")return null;let t=localStorage.getItem(this.consentStorageKey());if(!t)return null;let r=JSON.parse(t);return{analytics:!!r.analytics,heatmaps:!!r.heatmaps,geo:!!r.geo}}catch{return null}}persistConsent(){try{if(typeof localStorage>"u")return;localStorage.setItem(this.consentStorageKey(),JSON.stringify(this.consent))}catch{}}promotePersistentIds(){this.distinctId=he(),this.sessionId=pe()}canTrackAnalytics(){return!!this.consent.analytics}isHeatmapFeatureEnabled(){return!this.config.heatmap||this.configFetched&&!this.serverConfig?.heatmaps_enabled?!1:!!this.consent.heatmaps}async fetchConfig(){if(typeof window>"u")return;let t=`_krypton_config_${this.config.apiKey}`,r=null;try{r=sessionStorage.getItem(t)}catch{r=null}if(r)try{let i=JSON.parse(r);if(i._ts&&Date.now()-i._ts<300*1e3){this.serverConfig=i,this.configFetched=!0;return}}catch{}try{let i=await fetch(`${this.config.endpoint}/api/v1/config?api_key=${encodeURIComponent(this.config.apiKey)}`);if(i.ok){let n=await i.json();this.serverConfig=n,this.configFetched=!0;try{sessionStorage.setItem(t,JSON.stringify({...n,_ts:Date.now()}))}catch{}}}catch{}}setupTracking(){if(this.flushTimer=setInterval(()=>this.flush(),this.config.flushInterval),typeof window>"u")return;window.addEventListener("beforeunload",()=>this.flush()),this.config.autoPageview&&this.canTrackAnalytics()&&this.trackPageview();let t=history.pushState;history.pushState=(...i)=>{t.apply(history,i),this.config.autoPageview&&this.canTrackAnalytics()&&setTimeout(()=>this.trackPageview(),0),this.isHeatmapFeatureEnabled()&&setTimeout(()=>this.captureSnapshot(),0)};let r=history.replaceState;history.replaceState=(...i)=>{r.apply(history,i),this.config.autoPageview&&this.canTrackAnalytics()&&setTimeout(()=>this.trackPageview(),0),this.isHeatmapFeatureEnabled()&&setTimeout(()=>this.captureSnapshot(),0)},window.addEventListener("popstate",()=>{this.config.autoPageview&&this.canTrackAnalytics()&&setTimeout(()=>this.trackPageview(),0),this.isHeatmapFeatureEnabled()&&setTimeout(()=>this.captureSnapshot(),0)}),this.isHeatmapFeatureEnabled()&&this.setupHeatmap(),this.consent.geo&&this.captureGeoOnce()}showConsentBanner(){if(typeof document>"u"||document.getElementById("krypton-consent-banner"))return;let t=document.createElement("div");t.id="krypton-consent-banner",t.style.cssText=["position:fixed","left:16px","right:16px","bottom:16px","z-index:2147483647","max-width:720px","margin:0 auto","background:#111827","color:#f9fafb","border-radius:12px","padding:16px","box-shadow:0 12px 30px rgba(0,0,0,0.35)","font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif","font-size:14px","line-height:1.4"].join(";");let r=a=>a?"checked":"";t.innerHTML=`
+      <div style="font-weight:600;margin-bottom:6px">Privacy preferences</div>
+      <div style="opacity:0.9;margin-bottom:10px">Choose what data you allow us to collect.</div>
+      <label style="display:flex;gap:8px;align-items:flex-start;margin:6px 0">
+        <input type="checkbox" id="krypton-consent-analytics" ${r(this.consent.analytics)} />
+        <span><strong>Analytics</strong> (pageviews and custom events)</span>
+      </label>
+      <label style="display:flex;gap:8px;align-items:flex-start;margin:6px 0">
+        <input type="checkbox" id="krypton-consent-heatmaps" ${r(this.consent.heatmaps)} />
+        <span><strong>Heatmaps</strong> (click and scroll interaction maps)</span>
+      </label>
+      <label style="display:flex;gap:8px;align-items:flex-start;margin:6px 0 12px 0">
+        <input type="checkbox" id="krypton-consent-geo" ${r(this.consent.geo)} />
+        <span><strong>Geo location</strong> (browser geolocation if available)</span>
+      </label>
+      <div style="display:flex;gap:8px;flex-wrap:wrap">
+        <button id="krypton-consent-save" style="border:0;background:#2563eb;color:#fff;padding:8px 12px;border-radius:8px;cursor:pointer">Accept selected</button>
+        <button id="krypton-consent-all" style="border:0;background:#16a34a;color:#fff;padding:8px 12px;border-radius:8px;cursor:pointer">Accept all</button>
+        <button id="krypton-consent-none" style="border:1px solid #4b5563;background:transparent;color:#f9fafb;padding:8px 12px;border-radius:8px;cursor:pointer">Reject all</button>
+      </div>
+    `;let i=()=>{t.remove()},n=a=>!!document.getElementById(a)?.checked;t.querySelector("#krypton-consent-save")?.addEventListener("click",()=>{this.setConsent({analytics:n("krypton-consent-analytics"),heatmaps:n("krypton-consent-heatmaps"),geo:n("krypton-consent-geo")}),i()}),t.querySelector("#krypton-consent-all")?.addEventListener("click",()=>{this.setConsent({analytics:!0,heatmaps:!0,geo:!0}),i()}),t.querySelector("#krypton-consent-none")?.addEventListener("click",()=>{this.setConsent({analytics:!1,heatmaps:!1,geo:!1}),i()}),document.body.appendChild(t)}setConsent(t,r=!0){let i={...this.consent};this.consent={analytics:t.analytics??i.analytics,heatmaps:t.heatmaps??i.heatmaps,geo:t.geo??i.geo},r&&this.persistConsent(),!i.analytics&&this.consent.analytics&&(this.promotePersistentIds(),this.config.autoPageview&&this.trackPageview()),i.analytics&&!this.consent.analytics&&(this.eventQueue=[]),!i.heatmaps&&this.isHeatmapFeatureEnabled()&&(this.setupHeatmap(),this.captureSnapshot()),i.heatmaps&&!this.consent.heatmaps&&(this.heatmapQueue=[]),!i.geo&&this.consent.geo&&this.captureGeoOnce()}getConsent(){return{...this.consent}}grantConsent(){this.setConsent({analytics:!0,heatmaps:!0,geo:!0})}revokeConsent(){this.setConsent({analytics:!1,heatmaps:!1,geo:!1}),this.eventQueue=[],this.heatmapQueue=[]}identify(t){if(this.distinctId=t,this.canTrackAnalytics())try{typeof localStorage<"u"&&localStorage.setItem("_krypton_did",t)}catch{}}trackPageview(t){this.canTrackAnalytics()&&this.track("$pageview",{...t})}track(t,r){if(!this.canTrackAnalytics())return;let i=me(),n={...r||{}};this.consent.geo&&this.geoContext&&(n.geo=this.geoContext);let a={project_id:this.config.apiKey,distinct_id:this.distinctId,event_name:t,timestamp:new Date().toISOString(),properties:n,page_url:typeof window<"u"?window.location.href:"",page_title:typeof document<"u"?document.title:"",referrer:typeof document<"u"?document.referrer:"",utm_source:i.utm_source||"",utm_medium:i.utm_medium||"",utm_campaign:i.utm_campaign||"",utm_term:i.utm_term||"",utm_content:i.utm_content||"",device_type:ge(),browser:this.getBrowser(),screen_width:typeof window<"u"?window.screen.width:0,screen_height:typeof window<"u"?window.screen.height:0,session_id:this.sessionId};this.eventQueue.push(a),this.eventQueue.length>=this.config.batchSize&&this.flush()}async flush(){await Promise.all([this.flushEvents(),this.flushHeatmapEvents()])}shutdown(){this.flushTimer&&(clearInterval(this.flushTimer),this.flushTimer=null),this.flush()}captureGeoOnce(){this.geoRequested||this.consent.geo&&(typeof navigator>"u"||!navigator.geolocation||(this.geoRequested=!0,navigator.geolocation.getCurrentPosition(t=>{let r=(i,n=3)=>Number(i.toFixed(n));this.geoContext={lat:r(t.coords.latitude),lon:r(t.coords.longitude),accuracy_m:Math.round(t.coords.accuracy),captured_at:new Date().toISOString()}},()=>{},{enableHighAccuracy:!1,maximumAge:600*1e3,timeout:5e3})))}async flushEvents(){if(this.eventQueue.length===0)return;let t=this.eventQueue.splice(0,this.eventQueue.length),r={api_key:this.config.apiKey,events:t};try{await fetch(`${this.config.endpoint}/api/v1/ingest/batch`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(r),keepalive:!0})}catch{this.eventQueue.length<this.config.batchSize*5&&this.eventQueue.unshift(...t)}}async flushHeatmapEvents(){if(this.heatmapQueue.length===0)return;let t=this.heatmapQueue.splice(0,this.heatmapQueue.length),r={api_key:this.config.apiKey,events:t};try{await fetch(`${this.config.endpoint}/api/v1/heatmap`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(r),keepalive:!0})}catch{this.heatmapQueue.length<this.config.batchSize*5&&this.heatmapQueue.unshift(...t)}}captureSnapshot(){if(typeof window>"u"||typeof document>"u"||!this.isHeatmapFeatureEnabled())return;let t=window.location.href;this.lastSnapshotUrl!==t&&(this.lastSnapshotUrl=t,setTimeout(()=>{try{let r=de(document,{maskAllInputs:!0,blockSelector:"[data-krypton-block]",inlineStylesheet:!0});if(!r)return;let i=JSON.stringify(r),n={api_key:this.config.apiKey,page_url:t,snapshot:i,viewport_width:window.innerWidth,viewport_height:window.innerHeight,page_width:document.documentElement.scrollWidth,page_height:document.documentElement.scrollHeight,timestamp:new Date().toISOString()};fetch(`${this.config.endpoint}/api/v1/snapshot`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(n),keepalive:!0}).catch(()=>{})}catch{}},1e3))}setupHeatmap(){if(typeof window>"u"||this.heatmapSetup)return;this.heatmapSetup=!0,this.captureSnapshot(),document.addEventListener("click",i=>{if(!this.isHeatmapFeatureEnabled())return;let n=i.target;this.heatmapQueue.push({project_id:this.config.apiKey,distinct_id:this.distinctId,session_id:this.sessionId,timestamp:new Date().toISOString(),page_url:window.location.href,interaction_type:"click",x:i.clientX+window.scrollX,y:i.clientY+window.scrollY,viewport_width:window.innerWidth,viewport_height:window.innerHeight,page_width:document.documentElement.scrollWidth,page_height:document.documentElement.scrollHeight,selector:ve(n)})});let t=0,r=null;window.addEventListener("scroll",()=>{if(!this.isHeatmapFeatureEnabled())return;let i=window.scrollY||document.documentElement.scrollTop,n=document.documentElement.scrollHeight-window.innerHeight,a=n>0?i/n*100:0;a>t&&(t=a),r&&clearTimeout(r),r=setTimeout(()=>{this.heatmapQueue.push({project_id:this.config.apiKey,distinct_id:this.distinctId,session_id:this.sessionId,timestamp:new Date().toISOString(),page_url:window.location.href,interaction_type:"scroll",scroll_depth:t,viewport_width:window.innerWidth,viewport_height:window.innerHeight,page_width:document.documentElement.scrollWidth,page_height:document.documentElement.scrollHeight})},500)})}getBrowser(){if(typeof navigator>"u")return"unknown";let t=navigator.userAgent;return t.includes("Firefox")?"Firefox":t.includes("Edg")?"Edge":t.includes("Chrome")?"Chrome":t.includes("Safari")?"Safari":"Other"}};function ye(e){return new q(e)}var ke={Krypton:q,init:ye};typeof window<"u"&&(window.KryptonAnalytics=ke);var nt=ke;return Ie(at);})();

package/dist/index.d.mts

@@ -9,11 +9,21 @@ interface KryptonConfig {
     heatmap?: boolean;
     /** Require consent before tracking (default: false) */
     consentRequired?: boolean;
+    /** Show a built-in consent popup (default: false) */
+    showConsentBanner?: boolean;
+    /** Optional initial consent values (default deny when consentRequired=true) */
+    consentCategories?: Partial<ConsentPreferences>;
     /** Flush interval in milliseconds (default: 5000) */
     flushInterval?: number;
     /** Max events per batch (default: 20) */
     batchSize?: number;
 }
+type ConsentCategory = "analytics" | "heatmaps" | "geo";
+interface ConsentPreferences {
+    analytics: boolean;
+    heatmaps: boolean;
+    geo: boolean;
+}
 interface EventPayload {
     project_id: string;
     distinct_id: string;
@@ -61,18 +71,34 @@ declare class Krypton {
     private eventQueue;
     private heatmapQueue;
     private flushTimer;
-    private consentGiven;
     private initialized;
     private lastSnapshotUrl;
+    private heatmapSetup;
+    private geoRequested;
+    private geoContext;
+    private consent;
     private serverConfig;
     private configFetched;
     constructor(config: KryptonConfig);
     private init;
+    private resolveInitialConsent;
+    private consentStorageKey;
+    private hasStoredConsent;
+    private loadStoredConsent;
+    private persistConsent;
+    private promotePersistentIds;
+    private canTrackAnalytics;
+    private isHeatmapFeatureEnabled;
     private fetchConfig;
     private setupTracking;
-    /** Grant consent and begin tracking */
+    /** Built-in consent popup with category toggles (analytics, heatmaps, geo). */
+    showConsentBanner(): void;
+    /** Set one or more consent categories and apply changes immediately. */
+    setConsent(next: Partial<ConsentPreferences>, persist?: boolean): void;
+    getConsent(): ConsentPreferences;
+    /** Backward-compatible: grant all categories. */
     grantConsent(): void;
-    /** Revoke consent and stop tracking */
+    /** Backward-compatible: revoke all categories and clear queues. */
     revokeConsent(): void;
     /** Identify a user with a custom distinct ID */
     identify(distinctId: string): void;
@@ -80,10 +106,9 @@ declare class Krypton {
     trackPageview(properties?: Record<string, unknown>): void;
     /** Track a custom event */
     track(eventName: string, properties?: Record<string, unknown>): void;
-    /** Flush all queued events to the server */
     flush(): Promise<void>;
-    /** Shutdown the SDK */
     shutdown(): void;
+    private captureGeoOnce;
     private flushEvents;
     private flushHeatmapEvents;
     private captureSnapshot;
@@ -92,4 +117,4 @@ declare class Krypton {
 }
 declare function createKrypton(config: KryptonConfig): Krypton;
 
-export { type EventPayload, type HeatmapEventPayload, Krypton, type KryptonConfig, createKrypton };
+export { type ConsentCategory, type ConsentPreferences, type EventPayload, type HeatmapEventPayload, Krypton, type KryptonConfig, createKrypton };

package/dist/index.d.ts

@@ -9,11 +9,21 @@ interface KryptonConfig {
     heatmap?: boolean;
     /** Require consent before tracking (default: false) */
     consentRequired?: boolean;
+    /** Show a built-in consent popup (default: false) */
+    showConsentBanner?: boolean;
+    /** Optional initial consent values (default deny when consentRequired=true) */
+    consentCategories?: Partial<ConsentPreferences>;
     /** Flush interval in milliseconds (default: 5000) */
     flushInterval?: number;
     /** Max events per batch (default: 20) */
     batchSize?: number;
 }
+type ConsentCategory = "analytics" | "heatmaps" | "geo";
+interface ConsentPreferences {
+    analytics: boolean;
+    heatmaps: boolean;
+    geo: boolean;
+}
 interface EventPayload {
     project_id: string;
     distinct_id: string;
@@ -61,18 +71,34 @@ declare class Krypton {
     private eventQueue;
     private heatmapQueue;
     private flushTimer;
-    private consentGiven;
     private initialized;
     private lastSnapshotUrl;
+    private heatmapSetup;
+    private geoRequested;
+    private geoContext;
+    private consent;
     private serverConfig;
     private configFetched;
     constructor(config: KryptonConfig);
     private init;
+    private resolveInitialConsent;
+    private consentStorageKey;
+    private hasStoredConsent;
+    private loadStoredConsent;
+    private persistConsent;
+    private promotePersistentIds;
+    private canTrackAnalytics;
+    private isHeatmapFeatureEnabled;
     private fetchConfig;
     private setupTracking;
-    /** Grant consent and begin tracking */
+    /** Built-in consent popup with category toggles (analytics, heatmaps, geo). */
+    showConsentBanner(): void;
+    /** Set one or more consent categories and apply changes immediately. */
+    setConsent(next: Partial<ConsentPreferences>, persist?: boolean): void;
+    getConsent(): ConsentPreferences;
+    /** Backward-compatible: grant all categories. */
     grantConsent(): void;
-    /** Revoke consent and stop tracking */
+    /** Backward-compatible: revoke all categories and clear queues. */
     revokeConsent(): void;
     /** Identify a user with a custom distinct ID */
     identify(distinctId: string): void;
@@ -80,10 +106,9 @@ declare class Krypton {
     trackPageview(properties?: Record<string, unknown>): void;
     /** Track a custom event */
     track(eventName: string, properties?: Record<string, unknown>): void;
-    /** Flush all queued events to the server */
     flush(): Promise<void>;
-    /** Shutdown the SDK */
     shutdown(): void;
+    private captureGeoOnce;
     private flushEvents;
     private flushHeatmapEvents;
     private captureSnapshot;
@@ -92,4 +117,4 @@ declare class Krypton {
 }
 declare function createKrypton(config: KryptonConfig): Krypton;
 
-export { type EventPayload, type HeatmapEventPayload, Krypton, type KryptonConfig, createKrypton };
+export { type ConsentCategory, type ConsentPreferences, type EventPayload, type HeatmapEventPayload, Krypton, type KryptonConfig, createKrypton };

package/dist/index.js

@@ -39,25 +39,31 @@ function generateId() {
 }
 function getSessionId() {
   const key = "_krypton_sid";
-  if (typeof sessionStorage !== "undefined") {
-    let sid = sessionStorage.getItem(key);
-    if (!sid) {
-      sid = generateId();
-      sessionStorage.setItem(key, sid);
+  try {
+    if (typeof sessionStorage !== "undefined") {
+      let sid = sessionStorage.getItem(key);
+      if (!sid) {
+        sid = generateId();
+        sessionStorage.setItem(key, sid);
+      }
+      return sid;
     }
-    return sid;
+  } catch {
   }
   return generateId();
 }
 function getDistinctId() {
   const key = "_krypton_did";
-  if (typeof localStorage !== "undefined") {
-    let did = localStorage.getItem(key);
-    if (!did) {
-      did = generateId();
-      localStorage.setItem(key, did);
+  try {
+    if (typeof localStorage !== "undefined") {
+      let did = localStorage.getItem(key);
+      if (!did) {
+        did = generateId();
+        localStorage.setItem(key, did);
+      }
+      return did;
     }
-    return did;
+  } catch {
   }
   return generateId();
 }
@@ -104,35 +110,108 @@ var Krypton = class {
     this.eventQueue = [];
     this.heatmapQueue = [];
     this.flushTimer = null;
-    this.consentGiven = false;
     this.initialized = false;
     this.lastSnapshotUrl = null;
+    this.heatmapSetup = false;
+    this.geoRequested = false;
+    this.geoContext = null;
     this.serverConfig = null;
     this.configFetched = false;
     this.config = {
       autoPageview: true,
       heatmap: false,
       consentRequired: false,
+      showConsentBanner: false,
+      consentCategories: {},
       flushInterval: 5e3,
       batchSize: 20,
       ...config
     };
-    this.distinctId = getDistinctId();
-    this.sessionId = getSessionId();
-    if (!this.config.consentRequired) {
-      this.consentGiven = true;
+    this.distinctId = generateId();
+    this.sessionId = generateId();
+    this.consent = this.resolveInitialConsent();
+    if (this.canTrackAnalytics()) {
+      this.promotePersistentIds();
     }
     this.init();
   }
   init() {
     if (this.initialized) return;
     this.initialized = true;
-    this.fetchConfig().then(() => this.setupTracking());
+    this.fetchConfig().then(() => {
+      this.setupTracking();
+      if (this.config.consentRequired && this.config.showConsentBanner && !this.hasStoredConsent()) {
+        this.showConsentBanner();
+      }
+    });
+  }
+  resolveInitialConsent() {
+    const stored = this.loadStoredConsent();
+    if (stored) return stored;
+    const base = this.config.consentRequired ? { analytics: false, heatmaps: false, geo: false } : {
+      analytics: true,
+      heatmaps: !!this.config.heatmap,
+      geo: false
+    };
+    return {
+      ...base,
+      ...this.config.consentCategories
+    };
+  }
+  consentStorageKey() {
+    return `_krypton_consent_${this.config.apiKey}`;
+  }
+  hasStoredConsent() {
+    try {
+      if (typeof localStorage === "undefined") return false;
+      return !!localStorage.getItem(this.consentStorageKey());
+    } catch {
+      return false;
+    }
+  }
+  loadStoredConsent() {
+    try {
+      if (typeof localStorage === "undefined") return null;
+      const raw = localStorage.getItem(this.consentStorageKey());
+      if (!raw) return null;
+      const parsed = JSON.parse(raw);
+      return {
+        analytics: !!parsed.analytics,
+        heatmaps: !!parsed.heatmaps,
+        geo: !!parsed.geo
+      };
+    } catch {
+      return null;
+    }
+  }
+  persistConsent() {
+    try {
+      if (typeof localStorage === "undefined") return;
+      localStorage.setItem(this.consentStorageKey(), JSON.stringify(this.consent));
+    } catch {
+    }
+  }
+  promotePersistentIds() {
+    this.distinctId = getDistinctId();
+    this.sessionId = getSessionId();
+  }
+  canTrackAnalytics() {
+    return !!this.consent.analytics;
+  }
+  isHeatmapFeatureEnabled() {
+    if (!this.config.heatmap) return false;
+    if (this.configFetched && !this.serverConfig?.heatmaps_enabled) return false;
+    return !!this.consent.heatmaps;
   }
   async fetchConfig() {
     if (typeof window === "undefined") return;
     const cacheKey = `_krypton_config_${this.config.apiKey}`;
-    const cached = sessionStorage.getItem(cacheKey);
+    let cached = null;
+    try {
+      cached = sessionStorage.getItem(cacheKey);
+    } catch {
+      cached = null;
+    }
     if (cached) {
       try {
         const parsed = JSON.parse(cached);
@@ -152,83 +231,203 @@ var Krypton = class {
         const data = await res.json();
         this.serverConfig = data;
         this.configFetched = true;
-        sessionStorage.setItem(cacheKey, JSON.stringify({ ...data, _ts: Date.now() }));
+        try {
+          sessionStorage.setItem(cacheKey, JSON.stringify({ ...data, _ts: Date.now() }));
+        } catch {
+        }
       }
     } catch {
     }
   }
   setupTracking() {
     this.flushTimer = setInterval(() => this.flush(), this.config.flushInterval);
-    if (typeof window !== "undefined") {
-      window.addEventListener("beforeunload", () => this.flush());
-      if (this.config.autoPageview && this.consentGiven) {
-        this.trackPageview();
+    if (typeof window === "undefined") return;
+    window.addEventListener("beforeunload", () => this.flush());
+    if (this.config.autoPageview && this.canTrackAnalytics()) {
+      this.trackPageview();
+    }
+    const originalPushState = history.pushState;
+    history.pushState = (...args) => {
+      originalPushState.apply(history, args);
+      if (this.config.autoPageview && this.canTrackAnalytics()) {
+        setTimeout(() => this.trackPageview(), 0);
       }
-      const heatmapEnabled = this.config.heatmap && (!this.configFetched || this.serverConfig?.heatmaps_enabled);
-      const originalPushState = history.pushState;
-      history.pushState = (...args) => {
-        originalPushState.apply(history, args);
-        if (this.config.autoPageview && this.consentGiven) {
-          setTimeout(() => this.trackPageview(), 0);
-        }
-        if (heatmapEnabled && this.consentGiven) {
-          setTimeout(() => this.captureSnapshot(), 0);
-        }
-      };
-      window.addEventListener("popstate", () => {
-        if (this.config.autoPageview && this.consentGiven) {
-          setTimeout(() => this.trackPageview(), 0);
-        }
-        if (heatmapEnabled && this.consentGiven) {
-          setTimeout(() => this.captureSnapshot(), 0);
-        }
-      });
-      if (heatmapEnabled && this.consentGiven) {
-        this.setupHeatmap();
+      if (this.isHeatmapFeatureEnabled()) {
+        setTimeout(() => this.captureSnapshot(), 0);
+      }
+    };
+    const originalReplaceState = history.replaceState;
+    history.replaceState = (...args) => {
+      originalReplaceState.apply(history, args);
+      if (this.config.autoPageview && this.canTrackAnalytics()) {
+        setTimeout(() => this.trackPageview(), 0);
       }
+      if (this.isHeatmapFeatureEnabled()) {
+        setTimeout(() => this.captureSnapshot(), 0);
+      }
+    };
+    window.addEventListener("popstate", () => {
+      if (this.config.autoPageview && this.canTrackAnalytics()) {
+        setTimeout(() => this.trackPageview(), 0);
+      }
+      if (this.isHeatmapFeatureEnabled()) {
+        setTimeout(() => this.captureSnapshot(), 0);
+      }
+    });
+    if (this.isHeatmapFeatureEnabled()) {
+      this.setupHeatmap();
+    }
+    if (this.consent.geo) {
+      this.captureGeoOnce();
     }
   }
-  /** Grant consent and begin tracking */
-  grantConsent() {
-    this.consentGiven = true;
-    if (this.config.autoPageview) {
-      this.trackPageview();
+  /** Built-in consent popup with category toggles (analytics, heatmaps, geo). */
+  showConsentBanner() {
+    if (typeof document === "undefined") return;
+    if (document.getElementById("krypton-consent-banner")) return;
+    const banner = document.createElement("div");
+    banner.id = "krypton-consent-banner";
+    banner.style.cssText = [
+      "position:fixed",
+      "left:16px",
+      "right:16px",
+      "bottom:16px",
+      "z-index:2147483647",
+      "max-width:720px",
+      "margin:0 auto",
+      "background:#111827",
+      "color:#f9fafb",
+      "border-radius:12px",
+      "padding:16px",
+      "box-shadow:0 12px 30px rgba(0,0,0,0.35)",
+      "font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif",
+      "font-size:14px",
+      "line-height:1.4"
+    ].join(";");
+    const checked = (value) => value ? "checked" : "";
+    banner.innerHTML = `
+      <div style="font-weight:600;margin-bottom:6px">Privacy preferences</div>
+      <div style="opacity:0.9;margin-bottom:10px">Choose what data you allow us to collect.</div>
+      <label style="display:flex;gap:8px;align-items:flex-start;margin:6px 0">
+        <input type="checkbox" id="krypton-consent-analytics" ${checked(this.consent.analytics)} />
+        <span><strong>Analytics</strong> (pageviews and custom events)</span>
+      </label>
+      <label style="display:flex;gap:8px;align-items:flex-start;margin:6px 0">
+        <input type="checkbox" id="krypton-consent-heatmaps" ${checked(this.consent.heatmaps)} />
+        <span><strong>Heatmaps</strong> (click and scroll interaction maps)</span>
+      </label>
+      <label style="display:flex;gap:8px;align-items:flex-start;margin:6px 0 12px 0">
+        <input type="checkbox" id="krypton-consent-geo" ${checked(this.consent.geo)} />
+        <span><strong>Geo location</strong> (browser geolocation if available)</span>
+      </label>
+      <div style="display:flex;gap:8px;flex-wrap:wrap">
+        <button id="krypton-consent-save" style="border:0;background:#2563eb;color:#fff;padding:8px 12px;border-radius:8px;cursor:pointer">Accept selected</button>
+        <button id="krypton-consent-all" style="border:0;background:#16a34a;color:#fff;padding:8px 12px;border-radius:8px;cursor:pointer">Accept all</button>
+        <button id="krypton-consent-none" style="border:1px solid #4b5563;background:transparent;color:#f9fafb;padding:8px 12px;border-radius:8px;cursor:pointer">Reject all</button>
+      </div>
+    `;
+    const remove = () => {
+      banner.remove();
+    };
+    const readValue = (id) => {
+      const el = document.getElementById(id);
+      return !!el?.checked;
+    };
+    banner.querySelector("#krypton-consent-save")?.addEventListener("click", () => {
+      this.setConsent({
+        analytics: readValue("krypton-consent-analytics"),
+        heatmaps: readValue("krypton-consent-heatmaps"),
+        geo: readValue("krypton-consent-geo")
+      });
+      remove();
+    });
+    banner.querySelector("#krypton-consent-all")?.addEventListener("click", () => {
+      this.setConsent({ analytics: true, heatmaps: true, geo: true });
+      remove();
+    });
+    banner.querySelector("#krypton-consent-none")?.addEventListener("click", () => {
+      this.setConsent({ analytics: false, heatmaps: false, geo: false });
+      remove();
+    });
+    document.body.appendChild(banner);
+  }
+  /** Set one or more consent categories and apply changes immediately. */
+  setConsent(next, persist = true) {
+    const prev = { ...this.consent };
+    this.consent = {
+      analytics: next.analytics ?? prev.analytics,
+      heatmaps: next.heatmaps ?? prev.heatmaps,
+      geo: next.geo ?? prev.geo
+    };
+    if (persist) {
+      this.persistConsent();
+    }
+    if (!prev.analytics && this.consent.analytics) {
+      this.promotePersistentIds();
+      if (this.config.autoPageview) {
+        this.trackPageview();
+      }
     }
-    const heatmapEnabled = this.config.heatmap && (!this.configFetched || this.serverConfig?.heatmaps_enabled);
-    if (heatmapEnabled) {
+    if (prev.analytics && !this.consent.analytics) {
+      this.eventQueue = [];
+    }
+    if (!prev.heatmaps && this.isHeatmapFeatureEnabled()) {
       this.setupHeatmap();
+      this.captureSnapshot();
+    }
+    if (prev.heatmaps && !this.consent.heatmaps) {
+      this.heatmapQueue = [];
+    }
+    if (!prev.geo && this.consent.geo) {
+      this.captureGeoOnce();
     }
   }
-  /** Revoke consent and stop tracking */
+  getConsent() {
+    return { ...this.consent };
+  }
+  /** Backward-compatible: grant all categories. */
+  grantConsent() {
+    this.setConsent({ analytics: true, heatmaps: true, geo: true });
+  }
+  /** Backward-compatible: revoke all categories and clear queues. */
   revokeConsent() {
-    this.consentGiven = false;
+    this.setConsent({ analytics: false, heatmaps: false, geo: false });
     this.eventQueue = [];
     this.heatmapQueue = [];
   }
   /** Identify a user with a custom distinct ID */
   identify(distinctId) {
     this.distinctId = distinctId;
-    if (typeof localStorage !== "undefined") {
-      localStorage.setItem("_krypton_did", distinctId);
+    if (this.canTrackAnalytics()) {
+      try {
+        if (typeof localStorage !== "undefined") {
+          localStorage.setItem("_krypton_did", distinctId);
+        }
+      } catch {
+      }
     }
   }
   /** Track a pageview */
   trackPageview(properties) {
-    if (!this.consentGiven) return;
+    if (!this.canTrackAnalytics()) return;
     this.track("$pageview", {
       ...properties
     });
   }
   /** Track a custom event */
   track(eventName, properties) {
-    if (!this.consentGiven) return;
+    if (!this.canTrackAnalytics()) return;
     const utm = getUTMParams();
+    const mergedProperties = { ...properties || {} };
+    if (this.consent.geo && this.geoContext) {
+      mergedProperties.geo = this.geoContext;
+    }
     const event = {
       project_id: this.config.apiKey,
       distinct_id: this.distinctId,
       event_name: eventName,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      properties,
+      properties: mergedProperties,
       page_url: typeof window !== "undefined" ? window.location.href : "",
       page_title: typeof document !== "undefined" ? document.title : "",
       referrer: typeof document !== "undefined" ? document.referrer : "",
@@ -248,11 +447,9 @@ var Krypton = class {
       this.flush();
     }
   }
-  /** Flush all queued events to the server */
   async flush() {
     await Promise.all([this.flushEvents(), this.flushHeatmapEvents()]);
   }
-  /** Shutdown the SDK */
   shutdown() {
     if (this.flushTimer) {
       clearInterval(this.flushTimer);
@@ -260,7 +457,30 @@ var Krypton = class {
     }
     this.flush();
   }
-  // ---- Private methods ----
+  captureGeoOnce() {
+    if (this.geoRequested) return;
+    if (!this.consent.geo) return;
+    if (typeof navigator === "undefined" || !navigator.geolocation) return;
+    this.geoRequested = true;
+    navigator.geolocation.getCurrentPosition(
+      (pos) => {
+        const round = (value, precision = 3) => Number(value.toFixed(precision));
+        this.geoContext = {
+          lat: round(pos.coords.latitude),
+          lon: round(pos.coords.longitude),
+          accuracy_m: Math.round(pos.coords.accuracy),
+          captured_at: (/* @__PURE__ */ new Date()).toISOString()
+        };
+      },
+      () => {
+      },
+      {
+        enableHighAccuracy: false,
+        maximumAge: 10 * 60 * 1e3,
+        timeout: 5e3
+      }
+    );
+  }
   async flushEvents() {
     if (this.eventQueue.length === 0) return;
     const events = this.eventQueue.splice(0, this.eventQueue.length);
@@ -303,6 +523,7 @@ var Krypton = class {
   }
   captureSnapshot() {
     if (typeof window === "undefined" || typeof document === "undefined") return;
+    if (!this.isHeatmapFeatureEnabled()) return;
     const currentUrl = window.location.href;
     if (this.lastSnapshotUrl === currentUrl) return;
     this.lastSnapshotUrl = currentUrl;
@@ -338,9 +559,11 @@ var Krypton = class {
   }
   setupHeatmap() {
     if (typeof window === "undefined") return;
+    if (this.heatmapSetup) return;
+    this.heatmapSetup = true;
     this.captureSnapshot();
     document.addEventListener("click", (e) => {
-      if (!this.consentGiven) return;
+      if (!this.isHeatmapFeatureEnabled()) return;
       const target = e.target;
       this.heatmapQueue.push({
         project_id: this.config.apiKey,
@@ -361,7 +584,7 @@ var Krypton = class {
     let maxScrollDepth = 0;
     let scrollTimeout = null;
     window.addEventListener("scroll", () => {
-      if (!this.consentGiven) return;
+      if (!this.isHeatmapFeatureEnabled()) return;
       const scrollTop = window.scrollY || document.documentElement.scrollTop;
       const docHeight = document.documentElement.scrollHeight - window.innerHeight;
       const depth = docHeight > 0 ? scrollTop / docHeight * 100 : 0;

package/dist/index.mjs

@@ -14,25 +14,31 @@ function generateId() {
 }
 function getSessionId() {
   const key = "_krypton_sid";
-  if (typeof sessionStorage !== "undefined") {
-    let sid = sessionStorage.getItem(key);
-    if (!sid) {
-      sid = generateId();
-      sessionStorage.setItem(key, sid);
+  try {
+    if (typeof sessionStorage !== "undefined") {
+      let sid = sessionStorage.getItem(key);
+      if (!sid) {
+        sid = generateId();
+        sessionStorage.setItem(key, sid);
+      }
+      return sid;
     }
-    return sid;
+  } catch {
   }
   return generateId();
 }
 function getDistinctId() {
   const key = "_krypton_did";
-  if (typeof localStorage !== "undefined") {
-    let did = localStorage.getItem(key);
-    if (!did) {
-      did = generateId();
-      localStorage.setItem(key, did);
+  try {
+    if (typeof localStorage !== "undefined") {
+      let did = localStorage.getItem(key);
+      if (!did) {
+        did = generateId();
+        localStorage.setItem(key, did);
+      }
+      return did;
     }
-    return did;
+  } catch {
   }
   return generateId();
 }
@@ -79,35 +85,108 @@ var Krypton = class {
     this.eventQueue = [];
     this.heatmapQueue = [];
     this.flushTimer = null;
-    this.consentGiven = false;
     this.initialized = false;
     this.lastSnapshotUrl = null;
+    this.heatmapSetup = false;
+    this.geoRequested = false;
+    this.geoContext = null;
     this.serverConfig = null;
     this.configFetched = false;
     this.config = {
       autoPageview: true,
       heatmap: false,
       consentRequired: false,
+      showConsentBanner: false,
+      consentCategories: {},
       flushInterval: 5e3,
       batchSize: 20,
       ...config
     };
-    this.distinctId = getDistinctId();
-    this.sessionId = getSessionId();
-    if (!this.config.consentRequired) {
-      this.consentGiven = true;
+    this.distinctId = generateId();
+    this.sessionId = generateId();
+    this.consent = this.resolveInitialConsent();
+    if (this.canTrackAnalytics()) {
+      this.promotePersistentIds();
     }
     this.init();
   }
   init() {
     if (this.initialized) return;
     this.initialized = true;
-    this.fetchConfig().then(() => this.setupTracking());
+    this.fetchConfig().then(() => {
+      this.setupTracking();
+      if (this.config.consentRequired && this.config.showConsentBanner && !this.hasStoredConsent()) {
+        this.showConsentBanner();
+      }
+    });
+  }
+  resolveInitialConsent() {
+    const stored = this.loadStoredConsent();
+    if (stored) return stored;
+    const base = this.config.consentRequired ? { analytics: false, heatmaps: false, geo: false } : {
+      analytics: true,
+      heatmaps: !!this.config.heatmap,
+      geo: false
+    };
+    return {
+      ...base,
+      ...this.config.consentCategories
+    };
+  }
+  consentStorageKey() {
+    return `_krypton_consent_${this.config.apiKey}`;
+  }
+  hasStoredConsent() {
+    try {
+      if (typeof localStorage === "undefined") return false;
+      return !!localStorage.getItem(this.consentStorageKey());
+    } catch {
+      return false;
+    }
+  }
+  loadStoredConsent() {
+    try {
+      if (typeof localStorage === "undefined") return null;
+      const raw = localStorage.getItem(this.consentStorageKey());
+      if (!raw) return null;
+      const parsed = JSON.parse(raw);
+      return {
+        analytics: !!parsed.analytics,
+        heatmaps: !!parsed.heatmaps,
+        geo: !!parsed.geo
+      };
+    } catch {
+      return null;
+    }
+  }
+  persistConsent() {
+    try {
+      if (typeof localStorage === "undefined") return;
+      localStorage.setItem(this.consentStorageKey(), JSON.stringify(this.consent));
+    } catch {
+    }
+  }
+  promotePersistentIds() {
+    this.distinctId = getDistinctId();
+    this.sessionId = getSessionId();
+  }
+  canTrackAnalytics() {
+    return !!this.consent.analytics;
+  }
+  isHeatmapFeatureEnabled() {
+    if (!this.config.heatmap) return false;
+    if (this.configFetched && !this.serverConfig?.heatmaps_enabled) return false;
+    return !!this.consent.heatmaps;
   }
   async fetchConfig() {
     if (typeof window === "undefined") return;
     const cacheKey = `_krypton_config_${this.config.apiKey}`;
-    const cached = sessionStorage.getItem(cacheKey);
+    let cached = null;
+    try {
+      cached = sessionStorage.getItem(cacheKey);
+    } catch {
+      cached = null;
+    }
     if (cached) {
       try {
         const parsed = JSON.parse(cached);
@@ -127,83 +206,203 @@ var Krypton = class {
         const data = await res.json();
         this.serverConfig = data;
         this.configFetched = true;
-        sessionStorage.setItem(cacheKey, JSON.stringify({ ...data, _ts: Date.now() }));
+        try {
+          sessionStorage.setItem(cacheKey, JSON.stringify({ ...data, _ts: Date.now() }));
+        } catch {
+        }
       }
     } catch {
     }
   }
   setupTracking() {
     this.flushTimer = setInterval(() => this.flush(), this.config.flushInterval);
-    if (typeof window !== "undefined") {
-      window.addEventListener("beforeunload", () => this.flush());
-      if (this.config.autoPageview && this.consentGiven) {
-        this.trackPageview();
+    if (typeof window === "undefined") return;
+    window.addEventListener("beforeunload", () => this.flush());
+    if (this.config.autoPageview && this.canTrackAnalytics()) {
+      this.trackPageview();
+    }
+    const originalPushState = history.pushState;
+    history.pushState = (...args) => {
+      originalPushState.apply(history, args);
+      if (this.config.autoPageview && this.canTrackAnalytics()) {
+        setTimeout(() => this.trackPageview(), 0);
       }
-      const heatmapEnabled = this.config.heatmap && (!this.configFetched || this.serverConfig?.heatmaps_enabled);
-      const originalPushState = history.pushState;
-      history.pushState = (...args) => {
-        originalPushState.apply(history, args);
-        if (this.config.autoPageview && this.consentGiven) {
-          setTimeout(() => this.trackPageview(), 0);
-        }
-        if (heatmapEnabled && this.consentGiven) {
-          setTimeout(() => this.captureSnapshot(), 0);
-        }
-      };
-      window.addEventListener("popstate", () => {
-        if (this.config.autoPageview && this.consentGiven) {
-          setTimeout(() => this.trackPageview(), 0);
-        }
-        if (heatmapEnabled && this.consentGiven) {
-          setTimeout(() => this.captureSnapshot(), 0);
-        }
-      });
-      if (heatmapEnabled && this.consentGiven) {
-        this.setupHeatmap();
+      if (this.isHeatmapFeatureEnabled()) {
+        setTimeout(() => this.captureSnapshot(), 0);
+      }
+    };
+    const originalReplaceState = history.replaceState;
+    history.replaceState = (...args) => {
+      originalReplaceState.apply(history, args);
+      if (this.config.autoPageview && this.canTrackAnalytics()) {
+        setTimeout(() => this.trackPageview(), 0);
       }
+      if (this.isHeatmapFeatureEnabled()) {
+        setTimeout(() => this.captureSnapshot(), 0);
+      }
+    };
+    window.addEventListener("popstate", () => {
+      if (this.config.autoPageview && this.canTrackAnalytics()) {
+        setTimeout(() => this.trackPageview(), 0);
+      }
+      if (this.isHeatmapFeatureEnabled()) {
+        setTimeout(() => this.captureSnapshot(), 0);
+      }
+    });
+    if (this.isHeatmapFeatureEnabled()) {
+      this.setupHeatmap();
+    }
+    if (this.consent.geo) {
+      this.captureGeoOnce();
     }
   }
-  /** Grant consent and begin tracking */
-  grantConsent() {
-    this.consentGiven = true;
-    if (this.config.autoPageview) {
-      this.trackPageview();
+  /** Built-in consent popup with category toggles (analytics, heatmaps, geo). */
+  showConsentBanner() {
+    if (typeof document === "undefined") return;
+    if (document.getElementById("krypton-consent-banner")) return;
+    const banner = document.createElement("div");
+    banner.id = "krypton-consent-banner";
+    banner.style.cssText = [
+      "position:fixed",
+      "left:16px",
+      "right:16px",
+      "bottom:16px",
+      "z-index:2147483647",
+      "max-width:720px",
+      "margin:0 auto",
+      "background:#111827",
+      "color:#f9fafb",
+      "border-radius:12px",
+      "padding:16px",
+      "box-shadow:0 12px 30px rgba(0,0,0,0.35)",
+      "font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif",
+      "font-size:14px",
+      "line-height:1.4"
+    ].join(";");
+    const checked = (value) => value ? "checked" : "";
+    banner.innerHTML = `
+      <div style="font-weight:600;margin-bottom:6px">Privacy preferences</div>
+      <div style="opacity:0.9;margin-bottom:10px">Choose what data you allow us to collect.</div>
+      <label style="display:flex;gap:8px;align-items:flex-start;margin:6px 0">
+        <input type="checkbox" id="krypton-consent-analytics" ${checked(this.consent.analytics)} />
+        <span><strong>Analytics</strong> (pageviews and custom events)</span>
+      </label>
+      <label style="display:flex;gap:8px;align-items:flex-start;margin:6px 0">
+        <input type="checkbox" id="krypton-consent-heatmaps" ${checked(this.consent.heatmaps)} />
+        <span><strong>Heatmaps</strong> (click and scroll interaction maps)</span>
+      </label>
+      <label style="display:flex;gap:8px;align-items:flex-start;margin:6px 0 12px 0">
+        <input type="checkbox" id="krypton-consent-geo" ${checked(this.consent.geo)} />
+        <span><strong>Geo location</strong> (browser geolocation if available)</span>
+      </label>
+      <div style="display:flex;gap:8px;flex-wrap:wrap">
+        <button id="krypton-consent-save" style="border:0;background:#2563eb;color:#fff;padding:8px 12px;border-radius:8px;cursor:pointer">Accept selected</button>
+        <button id="krypton-consent-all" style="border:0;background:#16a34a;color:#fff;padding:8px 12px;border-radius:8px;cursor:pointer">Accept all</button>
+        <button id="krypton-consent-none" style="border:1px solid #4b5563;background:transparent;color:#f9fafb;padding:8px 12px;border-radius:8px;cursor:pointer">Reject all</button>
+      </div>
+    `;
+    const remove = () => {
+      banner.remove();
+    };
+    const readValue = (id) => {
+      const el = document.getElementById(id);
+      return !!el?.checked;
+    };
+    banner.querySelector("#krypton-consent-save")?.addEventListener("click", () => {
+      this.setConsent({
+        analytics: readValue("krypton-consent-analytics"),
+        heatmaps: readValue("krypton-consent-heatmaps"),
+        geo: readValue("krypton-consent-geo")
+      });
+      remove();
+    });
+    banner.querySelector("#krypton-consent-all")?.addEventListener("click", () => {
+      this.setConsent({ analytics: true, heatmaps: true, geo: true });
+      remove();
+    });
+    banner.querySelector("#krypton-consent-none")?.addEventListener("click", () => {
+      this.setConsent({ analytics: false, heatmaps: false, geo: false });
+      remove();
+    });
+    document.body.appendChild(banner);
+  }
+  /** Set one or more consent categories and apply changes immediately. */
+  setConsent(next, persist = true) {
+    const prev = { ...this.consent };
+    this.consent = {
+      analytics: next.analytics ?? prev.analytics,
+      heatmaps: next.heatmaps ?? prev.heatmaps,
+      geo: next.geo ?? prev.geo
+    };
+    if (persist) {
+      this.persistConsent();
+    }
+    if (!prev.analytics && this.consent.analytics) {
+      this.promotePersistentIds();
+      if (this.config.autoPageview) {
+        this.trackPageview();
+      }
     }
-    const heatmapEnabled = this.config.heatmap && (!this.configFetched || this.serverConfig?.heatmaps_enabled);
-    if (heatmapEnabled) {
+    if (prev.analytics && !this.consent.analytics) {
+      this.eventQueue = [];
+    }
+    if (!prev.heatmaps && this.isHeatmapFeatureEnabled()) {
       this.setupHeatmap();
+      this.captureSnapshot();
+    }
+    if (prev.heatmaps && !this.consent.heatmaps) {
+      this.heatmapQueue = [];
+    }
+    if (!prev.geo && this.consent.geo) {
+      this.captureGeoOnce();
     }
   }
-  /** Revoke consent and stop tracking */
+  getConsent() {
+    return { ...this.consent };
+  }
+  /** Backward-compatible: grant all categories. */
+  grantConsent() {
+    this.setConsent({ analytics: true, heatmaps: true, geo: true });
+  }
+  /** Backward-compatible: revoke all categories and clear queues. */
   revokeConsent() {
-    this.consentGiven = false;
+    this.setConsent({ analytics: false, heatmaps: false, geo: false });
     this.eventQueue = [];
     this.heatmapQueue = [];
   }
   /** Identify a user with a custom distinct ID */
   identify(distinctId) {
     this.distinctId = distinctId;
-    if (typeof localStorage !== "undefined") {
-      localStorage.setItem("_krypton_did", distinctId);
+    if (this.canTrackAnalytics()) {
+      try {
+        if (typeof localStorage !== "undefined") {
+          localStorage.setItem("_krypton_did", distinctId);
+        }
+      } catch {
+      }
     }
   }
   /** Track a pageview */
   trackPageview(properties) {
-    if (!this.consentGiven) return;
+    if (!this.canTrackAnalytics()) return;
     this.track("$pageview", {
       ...properties
     });
   }
   /** Track a custom event */
   track(eventName, properties) {
-    if (!this.consentGiven) return;
+    if (!this.canTrackAnalytics()) return;
     const utm = getUTMParams();
+    const mergedProperties = { ...properties || {} };
+    if (this.consent.geo && this.geoContext) {
+      mergedProperties.geo = this.geoContext;
+    }
     const event = {
       project_id: this.config.apiKey,
       distinct_id: this.distinctId,
       event_name: eventName,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      properties,
+      properties: mergedProperties,
       page_url: typeof window !== "undefined" ? window.location.href : "",
       page_title: typeof document !== "undefined" ? document.title : "",
       referrer: typeof document !== "undefined" ? document.referrer : "",
@@ -223,11 +422,9 @@ var Krypton = class {
       this.flush();
     }
   }
-  /** Flush all queued events to the server */
   async flush() {
     await Promise.all([this.flushEvents(), this.flushHeatmapEvents()]);
   }
-  /** Shutdown the SDK */
   shutdown() {
     if (this.flushTimer) {
       clearInterval(this.flushTimer);
@@ -235,7 +432,30 @@ var Krypton = class {
     }
     this.flush();
   }
-  // ---- Private methods ----
+  captureGeoOnce() {
+    if (this.geoRequested) return;
+    if (!this.consent.geo) return;
+    if (typeof navigator === "undefined" || !navigator.geolocation) return;
+    this.geoRequested = true;
+    navigator.geolocation.getCurrentPosition(
+      (pos) => {
+        const round = (value, precision = 3) => Number(value.toFixed(precision));
+        this.geoContext = {
+          lat: round(pos.coords.latitude),
+          lon: round(pos.coords.longitude),
+          accuracy_m: Math.round(pos.coords.accuracy),
+          captured_at: (/* @__PURE__ */ new Date()).toISOString()
+        };
+      },
+      () => {
+      },
+      {
+        enableHighAccuracy: false,
+        maximumAge: 10 * 60 * 1e3,
+        timeout: 5e3
+      }
+    );
+  }
   async flushEvents() {
     if (this.eventQueue.length === 0) return;
     const events = this.eventQueue.splice(0, this.eventQueue.length);
@@ -278,6 +498,7 @@ var Krypton = class {
   }
   captureSnapshot() {
     if (typeof window === "undefined" || typeof document === "undefined") return;
+    if (!this.isHeatmapFeatureEnabled()) return;
     const currentUrl = window.location.href;
     if (this.lastSnapshotUrl === currentUrl) return;
     this.lastSnapshotUrl = currentUrl;
@@ -313,9 +534,11 @@ var Krypton = class {
   }
   setupHeatmap() {
     if (typeof window === "undefined") return;
+    if (this.heatmapSetup) return;
+    this.heatmapSetup = true;
     this.captureSnapshot();
     document.addEventListener("click", (e) => {
-      if (!this.consentGiven) return;
+      if (!this.isHeatmapFeatureEnabled()) return;
       const target = e.target;
       this.heatmapQueue.push({
         project_id: this.config.apiKey,
@@ -336,7 +559,7 @@ var Krypton = class {
     let maxScrollDepth = 0;
     let scrollTimeout = null;
     window.addEventListener("scroll", () => {
-      if (!this.consentGiven) return;
+      if (!this.isHeatmapFeatureEnabled()) return;
       const scrollTop = window.scrollY || document.documentElement.scrollTop;
       const docHeight = document.documentElement.scrollHeight - window.innerHeight;
       const depth = docHeight > 0 ? scrollTop / docHeight * 100 : 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kryptonhq/analytics",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Krypton Analytics JavaScript SDK — privacy-first analytics tracking",
   "main": "dist/index.js",
   "module": "dist/index.mjs",