@kryptonhq/analytics 0.1.0

package/README.md

@@ -0,0 +1,103 @@
+# @kryptonhq/analytics
+
+Krypton Analytics JavaScript SDK.
+
+## Install (npm)
+
+```bash
+npm install @kryptonhq/analytics
+```
+
+```ts
+import { Krypton } from "@kryptonhq/analytics";
+
+const krypton = new Krypton({
+  apiKey: "kapi_xxx",
+  endpoint: "https://ingest.yourdomain.com",
+  autoPageview: true,
+  heatmap: true,
+});
+
+krypton.track("signup_clicked", { plan: "pro" });
+```
+
+## Install (CDN, script tag)
+
+Use jsDelivr:
+
+```html
+<script defer src="https://cdn.jsdelivr.net/npm/@kryptonhq/analytics@latest/dist/browser.global.js"></script>
+<script>
+  window.addEventListener("DOMContentLoaded", function () {
+    var krypton = window.KryptonAnalytics.init({
+      apiKey: "kapi_xxx",
+      endpoint: "https://ingest.yourdomain.com",
+      autoPageview: true,
+      heatmap: true
+    });
+
+    krypton.track("page_loaded");
+  });
+</script>
+```
+
+The CDN build exposes a global: `window.KryptonAnalytics`.
+
+### GA-style bootstrap snippet (single paste)
+
+```html
+<script>
+  (function (w, d, s, u, n) {
+    w[n] = w[n] || function () { (w[n].q = w[n].q || []).push(arguments); };
+    w[n].l = +new Date();
+    var js = d.createElement(s), fjs = d.getElementsByTagName(s)[0];
+    js.async = 1;
+    js.src = u;
+    js.onload = function () {
+      var cfg = w[n].cfg;
+      w[n].client = w.KryptonAnalytics.init(cfg);
+      var q = w[n].q || [];
+      for (var i = 0; i < q.length; i++) {
+        var args = q[i];
+        if (args[0] === "track") w[n].client.track(args[1], args[2]);
+      }
+    };
+    fjs.parentNode.insertBefore(js, fjs);
+  })(window, document, "script", "https://cdn.jsdelivr.net/npm/@kryptonhq/analytics@latest/dist/browser.global.js", "krypton");
+
+  krypton.cfg = {
+    apiKey: "kapi_xxx",
+    endpoint: "https://ingest.yourdomain.com",
+    autoPageview: true,
+    heatmap: true
+  };
+
+  krypton("track", "landing_view");
+</script>
+```
+
+## Publish to npm
+
+This repository includes a GitHub Actions workflow at:
+
+- `.github/workflows/publish-sdk.yml`
+
+It triggers on:
+
+- Manual run (`workflow_dispatch`)
+- Tag push matching `sdk-v*` (example: `sdk-v0.1.1`)
+
+Required GitHub secret:
+
+- None, when using npm Trusted Publishing (recommended)
+
+Publish flow:
+
+1. Configure npm Trusted Publishing for this package/repo in npm settings.
+2. Bump version in `package.json`.
+3. Commit and push.
+4. Create and push tag:
+   ```bash
+   git tag sdk-v0.1.1
+   git push origin sdk-v0.1.1
+   ```

package/dist/browser.global.js

@@ -0,0 +1 @@
+"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);})();

package/dist/index.d.mts

@@ -0,0 +1,95 @@
+interface KryptonConfig {
+    /** API key for the project */
+    apiKey: string;
+    /** Ingestion endpoint URL (e.g., "http://localhost:8090") */
+    endpoint: string;
+    /** Automatically track pageviews (default: true) */
+    autoPageview?: boolean;
+    /** Enable heatmap tracking (default: false) */
+    heatmap?: boolean;
+    /** Require consent before tracking (default: false) */
+    consentRequired?: boolean;
+    /** Flush interval in milliseconds (default: 5000) */
+    flushInterval?: number;
+    /** Max events per batch (default: 20) */
+    batchSize?: number;
+}
+interface EventPayload {
+    project_id: string;
+    distinct_id: string;
+    event_name: string;
+    timestamp: string;
+    properties?: Record<string, unknown>;
+    page_url?: string;
+    page_title?: string;
+    referrer?: string;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_term?: string;
+    utm_content?: string;
+    device_type?: string;
+    browser?: string;
+    browser_version?: string;
+    os?: string;
+    os_version?: string;
+    screen_width?: number;
+    screen_height?: number;
+    session_id?: string;
+}
+interface HeatmapEventPayload {
+    project_id: string;
+    distinct_id: string;
+    session_id?: string;
+    timestamp: string;
+    page_url: string;
+    interaction_type: "click" | "scroll" | "mousemove";
+    x?: number;
+    y?: number;
+    scroll_depth?: number;
+    viewport_width?: number;
+    viewport_height?: number;
+    page_width?: number;
+    page_height?: number;
+    selector?: string;
+}
+
+declare class Krypton {
+    private config;
+    private distinctId;
+    private sessionId;
+    private eventQueue;
+    private heatmapQueue;
+    private flushTimer;
+    private consentGiven;
+    private initialized;
+    private lastSnapshotUrl;
+    private serverConfig;
+    private configFetched;
+    constructor(config: KryptonConfig);
+    private init;
+    private fetchConfig;
+    private setupTracking;
+    /** Grant consent and begin tracking */
+    grantConsent(): void;
+    /** Revoke consent and stop tracking */
+    revokeConsent(): void;
+    /** Identify a user with a custom distinct ID */
+    identify(distinctId: string): void;
+    /** Track a pageview */
+    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 flushEvents;
+    private flushHeatmapEvents;
+    private captureSnapshot;
+    private setupHeatmap;
+    private getBrowser;
+}
+declare function createKrypton(config: KryptonConfig): Krypton;
+
+export { type EventPayload, type HeatmapEventPayload, Krypton, type KryptonConfig, createKrypton };

package/dist/index.d.ts

@@ -0,0 +1,95 @@
+interface KryptonConfig {
+    /** API key for the project */
+    apiKey: string;
+    /** Ingestion endpoint URL (e.g., "http://localhost:8090") */
+    endpoint: string;
+    /** Automatically track pageviews (default: true) */
+    autoPageview?: boolean;
+    /** Enable heatmap tracking (default: false) */
+    heatmap?: boolean;
+    /** Require consent before tracking (default: false) */
+    consentRequired?: boolean;
+    /** Flush interval in milliseconds (default: 5000) */
+    flushInterval?: number;
+    /** Max events per batch (default: 20) */
+    batchSize?: number;
+}
+interface EventPayload {
+    project_id: string;
+    distinct_id: string;
+    event_name: string;
+    timestamp: string;
+    properties?: Record<string, unknown>;
+    page_url?: string;
+    page_title?: string;
+    referrer?: string;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_term?: string;
+    utm_content?: string;
+    device_type?: string;
+    browser?: string;
+    browser_version?: string;
+    os?: string;
+    os_version?: string;
+    screen_width?: number;
+    screen_height?: number;
+    session_id?: string;
+}
+interface HeatmapEventPayload {
+    project_id: string;
+    distinct_id: string;
+    session_id?: string;
+    timestamp: string;
+    page_url: string;
+    interaction_type: "click" | "scroll" | "mousemove";
+    x?: number;
+    y?: number;
+    scroll_depth?: number;
+    viewport_width?: number;
+    viewport_height?: number;
+    page_width?: number;
+    page_height?: number;
+    selector?: string;
+}
+
+declare class Krypton {
+    private config;
+    private distinctId;
+    private sessionId;
+    private eventQueue;
+    private heatmapQueue;
+    private flushTimer;
+    private consentGiven;
+    private initialized;
+    private lastSnapshotUrl;
+    private serverConfig;
+    private configFetched;
+    constructor(config: KryptonConfig);
+    private init;
+    private fetchConfig;
+    private setupTracking;
+    /** Grant consent and begin tracking */
+    grantConsent(): void;
+    /** Revoke consent and stop tracking */
+    revokeConsent(): void;
+    /** Identify a user with a custom distinct ID */
+    identify(distinctId: string): void;
+    /** Track a pageview */
+    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 flushEvents;
+    private flushHeatmapEvents;
+    private captureSnapshot;
+    private setupHeatmap;
+    private getBrowser;
+}
+declare function createKrypton(config: KryptonConfig): Krypton;
+
+export { type EventPayload, type HeatmapEventPayload, Krypton, type KryptonConfig, createKrypton };

package/dist/index.js

@@ -0,0 +1,406 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Krypton: () => Krypton,
+  createKrypton: () => createKrypton
+});
+module.exports = __toCommonJS(index_exports);
+var import_rrweb_snapshot = require("rrweb-snapshot");
+
+// src/utils.ts
+function generateId() {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function getSessionId() {
+  const key = "_krypton_sid";
+  if (typeof sessionStorage !== "undefined") {
+    let sid = sessionStorage.getItem(key);
+    if (!sid) {
+      sid = generateId();
+      sessionStorage.setItem(key, sid);
+    }
+    return sid;
+  }
+  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);
+    }
+    return did;
+  }
+  return generateId();
+}
+function getUTMParams() {
+  if (typeof window === "undefined") return {};
+  const params = new URLSearchParams(window.location.search);
+  const utm = {};
+  for (const key of ["utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"]) {
+    const val = params.get(key);
+    if (val) utm[key] = val;
+  }
+  return utm;
+}
+function getDeviceType() {
+  if (typeof window === "undefined") return "unknown";
+  const w = window.innerWidth;
+  if (w < 768) return "mobile";
+  if (w < 1024) return "tablet";
+  return "desktop";
+}
+function getSelector(el) {
+  if (el.id) return `#${el.id}`;
+  const parts = [];
+  let current = el;
+  while (current && current !== document.body) {
+    let selector = current.tagName.toLowerCase();
+    if (current.id) {
+      parts.unshift(`#${current.id}`);
+      break;
+    }
+    if (current.className && typeof current.className === "string") {
+      const classes = current.className.trim().split(/\s+/).slice(0, 2).join(".");
+      if (classes) selector += `.${classes}`;
+    }
+    parts.unshift(selector);
+    current = current.parentElement;
+  }
+  return parts.join(" > ");
+}
+
+// src/index.ts
+var Krypton = class {
+  constructor(config) {
+    this.eventQueue = [];
+    this.heatmapQueue = [];
+    this.flushTimer = null;
+    this.consentGiven = false;
+    this.initialized = false;
+    this.lastSnapshotUrl = null;
+    this.serverConfig = null;
+    this.configFetched = false;
+    this.config = {
+      autoPageview: true,
+      heatmap: false,
+      consentRequired: false,
+      flushInterval: 5e3,
+      batchSize: 20,
+      ...config
+    };
+    this.distinctId = getDistinctId();
+    this.sessionId = getSessionId();
+    if (!this.config.consentRequired) {
+      this.consentGiven = true;
+    }
+    this.init();
+  }
+  init() {
+    if (this.initialized) return;
+    this.initialized = true;
+    this.fetchConfig().then(() => this.setupTracking());
+  }
+  async fetchConfig() {
+    if (typeof window === "undefined") return;
+    const cacheKey = `_krypton_config_${this.config.apiKey}`;
+    const cached = sessionStorage.getItem(cacheKey);
+    if (cached) {
+      try {
+        const parsed = JSON.parse(cached);
+        if (parsed._ts && Date.now() - parsed._ts < 5 * 60 * 1e3) {
+          this.serverConfig = parsed;
+          this.configFetched = true;
+          return;
+        }
+      } catch {
+      }
+    }
+    try {
+      const res = await fetch(
+        `${this.config.endpoint}/api/v1/config?api_key=${encodeURIComponent(this.config.apiKey)}`
+      );
+      if (res.ok) {
+        const data = await res.json();
+        this.serverConfig = data;
+        this.configFetched = true;
+        sessionStorage.setItem(cacheKey, JSON.stringify({ ...data, _ts: Date.now() }));
+      }
+    } 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();
+      }
+      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();
+      }
+    }
+  }
+  /** Grant consent and begin tracking */
+  grantConsent() {
+    this.consentGiven = true;
+    if (this.config.autoPageview) {
+      this.trackPageview();
+    }
+    const heatmapEnabled = this.config.heatmap && (!this.configFetched || this.serverConfig?.heatmaps_enabled);
+    if (heatmapEnabled) {
+      this.setupHeatmap();
+    }
+  }
+  /** Revoke consent and stop tracking */
+  revokeConsent() {
+    this.consentGiven = 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);
+    }
+  }
+  /** Track a pageview */
+  trackPageview(properties) {
+    if (!this.consentGiven) return;
+    this.track("$pageview", {
+      ...properties
+    });
+  }
+  /** Track a custom event */
+  track(eventName, properties) {
+    if (!this.consentGiven) return;
+    const utm = getUTMParams();
+    const event = {
+      project_id: this.config.apiKey,
+      distinct_id: this.distinctId,
+      event_name: eventName,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      properties,
+      page_url: typeof window !== "undefined" ? window.location.href : "",
+      page_title: typeof document !== "undefined" ? document.title : "",
+      referrer: typeof document !== "undefined" ? document.referrer : "",
+      utm_source: utm.utm_source || "",
+      utm_medium: utm.utm_medium || "",
+      utm_campaign: utm.utm_campaign || "",
+      utm_term: utm.utm_term || "",
+      utm_content: utm.utm_content || "",
+      device_type: getDeviceType(),
+      browser: this.getBrowser(),
+      screen_width: typeof window !== "undefined" ? window.screen.width : 0,
+      screen_height: typeof window !== "undefined" ? window.screen.height : 0,
+      session_id: this.sessionId
+    };
+    this.eventQueue.push(event);
+    if (this.eventQueue.length >= this.config.batchSize) {
+      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);
+      this.flushTimer = null;
+    }
+    this.flush();
+  }
+  // ---- Private methods ----
+  async flushEvents() {
+    if (this.eventQueue.length === 0) return;
+    const events = this.eventQueue.splice(0, this.eventQueue.length);
+    const payload = {
+      api_key: this.config.apiKey,
+      events
+    };
+    try {
+      await fetch(`${this.config.endpoint}/api/v1/ingest/batch`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload),
+        keepalive: true
+      });
+    } catch {
+      if (this.eventQueue.length < this.config.batchSize * 5) {
+        this.eventQueue.unshift(...events);
+      }
+    }
+  }
+  async flushHeatmapEvents() {
+    if (this.heatmapQueue.length === 0) return;
+    const events = this.heatmapQueue.splice(0, this.heatmapQueue.length);
+    const payload = {
+      api_key: this.config.apiKey,
+      events
+    };
+    try {
+      await fetch(`${this.config.endpoint}/api/v1/heatmap`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload),
+        keepalive: true
+      });
+    } catch {
+      if (this.heatmapQueue.length < this.config.batchSize * 5) {
+        this.heatmapQueue.unshift(...events);
+      }
+    }
+  }
+  captureSnapshot() {
+    if (typeof window === "undefined" || typeof document === "undefined") return;
+    const currentUrl = window.location.href;
+    if (this.lastSnapshotUrl === currentUrl) return;
+    this.lastSnapshotUrl = currentUrl;
+    setTimeout(() => {
+      try {
+        const node = (0, import_rrweb_snapshot.snapshot)(document, {
+          maskAllInputs: true,
+          blockSelector: "[data-krypton-block]",
+          inlineStylesheet: true
+        });
+        if (!node) return;
+        const snapshotJson = JSON.stringify(node);
+        const payload = {
+          api_key: this.config.apiKey,
+          page_url: currentUrl,
+          snapshot: snapshotJson,
+          viewport_width: window.innerWidth,
+          viewport_height: window.innerHeight,
+          page_width: document.documentElement.scrollWidth,
+          page_height: document.documentElement.scrollHeight,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        fetch(`${this.config.endpoint}/api/v1/snapshot`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(payload),
+          keepalive: true
+        }).catch(() => {
+        });
+      } catch {
+      }
+    }, 1e3);
+  }
+  setupHeatmap() {
+    if (typeof window === "undefined") return;
+    this.captureSnapshot();
+    document.addEventListener("click", (e) => {
+      if (!this.consentGiven) return;
+      const target = e.target;
+      this.heatmapQueue.push({
+        project_id: this.config.apiKey,
+        distinct_id: this.distinctId,
+        session_id: this.sessionId,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        page_url: window.location.href,
+        interaction_type: "click",
+        x: e.clientX + window.scrollX,
+        y: e.clientY + window.scrollY,
+        viewport_width: window.innerWidth,
+        viewport_height: window.innerHeight,
+        page_width: document.documentElement.scrollWidth,
+        page_height: document.documentElement.scrollHeight,
+        selector: getSelector(target)
+      });
+    });
+    let maxScrollDepth = 0;
+    let scrollTimeout = null;
+    window.addEventListener("scroll", () => {
+      if (!this.consentGiven) return;
+      const scrollTop = window.scrollY || document.documentElement.scrollTop;
+      const docHeight = document.documentElement.scrollHeight - window.innerHeight;
+      const depth = docHeight > 0 ? scrollTop / docHeight * 100 : 0;
+      if (depth > maxScrollDepth) {
+        maxScrollDepth = depth;
+      }
+      if (scrollTimeout) clearTimeout(scrollTimeout);
+      scrollTimeout = setTimeout(() => {
+        this.heatmapQueue.push({
+          project_id: this.config.apiKey,
+          distinct_id: this.distinctId,
+          session_id: this.sessionId,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          page_url: window.location.href,
+          interaction_type: "scroll",
+          scroll_depth: maxScrollDepth,
+          viewport_width: window.innerWidth,
+          viewport_height: window.innerHeight,
+          page_width: document.documentElement.scrollWidth,
+          page_height: document.documentElement.scrollHeight
+        });
+      }, 500);
+    });
+  }
+  getBrowser() {
+    if (typeof navigator === "undefined") return "unknown";
+    const ua = navigator.userAgent;
+    if (ua.includes("Firefox")) return "Firefox";
+    if (ua.includes("Edg")) return "Edge";
+    if (ua.includes("Chrome")) return "Chrome";
+    if (ua.includes("Safari")) return "Safari";
+    return "Other";
+  }
+};
+function createKrypton(config) {
+  return new Krypton(config);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Krypton,
+  createKrypton
+});

package/dist/index.mjs

@@ -0,0 +1,380 @@
+// src/index.ts
+import { snapshot as rrwebSnapshot } from "rrweb-snapshot";
+
+// src/utils.ts
+function generateId() {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function getSessionId() {
+  const key = "_krypton_sid";
+  if (typeof sessionStorage !== "undefined") {
+    let sid = sessionStorage.getItem(key);
+    if (!sid) {
+      sid = generateId();
+      sessionStorage.setItem(key, sid);
+    }
+    return sid;
+  }
+  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);
+    }
+    return did;
+  }
+  return generateId();
+}
+function getUTMParams() {
+  if (typeof window === "undefined") return {};
+  const params = new URLSearchParams(window.location.search);
+  const utm = {};
+  for (const key of ["utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"]) {
+    const val = params.get(key);
+    if (val) utm[key] = val;
+  }
+  return utm;
+}
+function getDeviceType() {
+  if (typeof window === "undefined") return "unknown";
+  const w = window.innerWidth;
+  if (w < 768) return "mobile";
+  if (w < 1024) return "tablet";
+  return "desktop";
+}
+function getSelector(el) {
+  if (el.id) return `#${el.id}`;
+  const parts = [];
+  let current = el;
+  while (current && current !== document.body) {
+    let selector = current.tagName.toLowerCase();
+    if (current.id) {
+      parts.unshift(`#${current.id}`);
+      break;
+    }
+    if (current.className && typeof current.className === "string") {
+      const classes = current.className.trim().split(/\s+/).slice(0, 2).join(".");
+      if (classes) selector += `.${classes}`;
+    }
+    parts.unshift(selector);
+    current = current.parentElement;
+  }
+  return parts.join(" > ");
+}
+
+// src/index.ts
+var Krypton = class {
+  constructor(config) {
+    this.eventQueue = [];
+    this.heatmapQueue = [];
+    this.flushTimer = null;
+    this.consentGiven = false;
+    this.initialized = false;
+    this.lastSnapshotUrl = null;
+    this.serverConfig = null;
+    this.configFetched = false;
+    this.config = {
+      autoPageview: true,
+      heatmap: false,
+      consentRequired: false,
+      flushInterval: 5e3,
+      batchSize: 20,
+      ...config
+    };
+    this.distinctId = getDistinctId();
+    this.sessionId = getSessionId();
+    if (!this.config.consentRequired) {
+      this.consentGiven = true;
+    }
+    this.init();
+  }
+  init() {
+    if (this.initialized) return;
+    this.initialized = true;
+    this.fetchConfig().then(() => this.setupTracking());
+  }
+  async fetchConfig() {
+    if (typeof window === "undefined") return;
+    const cacheKey = `_krypton_config_${this.config.apiKey}`;
+    const cached = sessionStorage.getItem(cacheKey);
+    if (cached) {
+      try {
+        const parsed = JSON.parse(cached);
+        if (parsed._ts && Date.now() - parsed._ts < 5 * 60 * 1e3) {
+          this.serverConfig = parsed;
+          this.configFetched = true;
+          return;
+        }
+      } catch {
+      }
+    }
+    try {
+      const res = await fetch(
+        `${this.config.endpoint}/api/v1/config?api_key=${encodeURIComponent(this.config.apiKey)}`
+      );
+      if (res.ok) {
+        const data = await res.json();
+        this.serverConfig = data;
+        this.configFetched = true;
+        sessionStorage.setItem(cacheKey, JSON.stringify({ ...data, _ts: Date.now() }));
+      }
+    } 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();
+      }
+      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();
+      }
+    }
+  }
+  /** Grant consent and begin tracking */
+  grantConsent() {
+    this.consentGiven = true;
+    if (this.config.autoPageview) {
+      this.trackPageview();
+    }
+    const heatmapEnabled = this.config.heatmap && (!this.configFetched || this.serverConfig?.heatmaps_enabled);
+    if (heatmapEnabled) {
+      this.setupHeatmap();
+    }
+  }
+  /** Revoke consent and stop tracking */
+  revokeConsent() {
+    this.consentGiven = 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);
+    }
+  }
+  /** Track a pageview */
+  trackPageview(properties) {
+    if (!this.consentGiven) return;
+    this.track("$pageview", {
+      ...properties
+    });
+  }
+  /** Track a custom event */
+  track(eventName, properties) {
+    if (!this.consentGiven) return;
+    const utm = getUTMParams();
+    const event = {
+      project_id: this.config.apiKey,
+      distinct_id: this.distinctId,
+      event_name: eventName,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      properties,
+      page_url: typeof window !== "undefined" ? window.location.href : "",
+      page_title: typeof document !== "undefined" ? document.title : "",
+      referrer: typeof document !== "undefined" ? document.referrer : "",
+      utm_source: utm.utm_source || "",
+      utm_medium: utm.utm_medium || "",
+      utm_campaign: utm.utm_campaign || "",
+      utm_term: utm.utm_term || "",
+      utm_content: utm.utm_content || "",
+      device_type: getDeviceType(),
+      browser: this.getBrowser(),
+      screen_width: typeof window !== "undefined" ? window.screen.width : 0,
+      screen_height: typeof window !== "undefined" ? window.screen.height : 0,
+      session_id: this.sessionId
+    };
+    this.eventQueue.push(event);
+    if (this.eventQueue.length >= this.config.batchSize) {
+      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);
+      this.flushTimer = null;
+    }
+    this.flush();
+  }
+  // ---- Private methods ----
+  async flushEvents() {
+    if (this.eventQueue.length === 0) return;
+    const events = this.eventQueue.splice(0, this.eventQueue.length);
+    const payload = {
+      api_key: this.config.apiKey,
+      events
+    };
+    try {
+      await fetch(`${this.config.endpoint}/api/v1/ingest/batch`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload),
+        keepalive: true
+      });
+    } catch {
+      if (this.eventQueue.length < this.config.batchSize * 5) {
+        this.eventQueue.unshift(...events);
+      }
+    }
+  }
+  async flushHeatmapEvents() {
+    if (this.heatmapQueue.length === 0) return;
+    const events = this.heatmapQueue.splice(0, this.heatmapQueue.length);
+    const payload = {
+      api_key: this.config.apiKey,
+      events
+    };
+    try {
+      await fetch(`${this.config.endpoint}/api/v1/heatmap`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload),
+        keepalive: true
+      });
+    } catch {
+      if (this.heatmapQueue.length < this.config.batchSize * 5) {
+        this.heatmapQueue.unshift(...events);
+      }
+    }
+  }
+  captureSnapshot() {
+    if (typeof window === "undefined" || typeof document === "undefined") return;
+    const currentUrl = window.location.href;
+    if (this.lastSnapshotUrl === currentUrl) return;
+    this.lastSnapshotUrl = currentUrl;
+    setTimeout(() => {
+      try {
+        const node = rrwebSnapshot(document, {
+          maskAllInputs: true,
+          blockSelector: "[data-krypton-block]",
+          inlineStylesheet: true
+        });
+        if (!node) return;
+        const snapshotJson = JSON.stringify(node);
+        const payload = {
+          api_key: this.config.apiKey,
+          page_url: currentUrl,
+          snapshot: snapshotJson,
+          viewport_width: window.innerWidth,
+          viewport_height: window.innerHeight,
+          page_width: document.documentElement.scrollWidth,
+          page_height: document.documentElement.scrollHeight,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        fetch(`${this.config.endpoint}/api/v1/snapshot`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(payload),
+          keepalive: true
+        }).catch(() => {
+        });
+      } catch {
+      }
+    }, 1e3);
+  }
+  setupHeatmap() {
+    if (typeof window === "undefined") return;
+    this.captureSnapshot();
+    document.addEventListener("click", (e) => {
+      if (!this.consentGiven) return;
+      const target = e.target;
+      this.heatmapQueue.push({
+        project_id: this.config.apiKey,
+        distinct_id: this.distinctId,
+        session_id: this.sessionId,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        page_url: window.location.href,
+        interaction_type: "click",
+        x: e.clientX + window.scrollX,
+        y: e.clientY + window.scrollY,
+        viewport_width: window.innerWidth,
+        viewport_height: window.innerHeight,
+        page_width: document.documentElement.scrollWidth,
+        page_height: document.documentElement.scrollHeight,
+        selector: getSelector(target)
+      });
+    });
+    let maxScrollDepth = 0;
+    let scrollTimeout = null;
+    window.addEventListener("scroll", () => {
+      if (!this.consentGiven) return;
+      const scrollTop = window.scrollY || document.documentElement.scrollTop;
+      const docHeight = document.documentElement.scrollHeight - window.innerHeight;
+      const depth = docHeight > 0 ? scrollTop / docHeight * 100 : 0;
+      if (depth > maxScrollDepth) {
+        maxScrollDepth = depth;
+      }
+      if (scrollTimeout) clearTimeout(scrollTimeout);
+      scrollTimeout = setTimeout(() => {
+        this.heatmapQueue.push({
+          project_id: this.config.apiKey,
+          distinct_id: this.distinctId,
+          session_id: this.sessionId,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          page_url: window.location.href,
+          interaction_type: "scroll",
+          scroll_depth: maxScrollDepth,
+          viewport_width: window.innerWidth,
+          viewport_height: window.innerHeight,
+          page_width: document.documentElement.scrollWidth,
+          page_height: document.documentElement.scrollHeight
+        });
+      }, 500);
+    });
+  }
+  getBrowser() {
+    if (typeof navigator === "undefined") return "unknown";
+    const ua = navigator.userAgent;
+    if (ua.includes("Firefox")) return "Firefox";
+    if (ua.includes("Edg")) return "Edge";
+    if (ua.includes("Chrome")) return "Chrome";
+    if (ua.includes("Safari")) return "Safari";
+    return "Other";
+  }
+};
+function createKrypton(config) {
+  return new Krypton(config);
+}
+export {
+  Krypton,
+  createKrypton
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@kryptonhq/analytics",
+  "version": "0.1.0",
+  "description": "Krypton Analytics JavaScript SDK — privacy-first analytics tracking",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "unpkg": "dist/browser.global.js",
+  "jsdelivr": "dist/browser.global.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "npm run build:lib && npm run build:cdn",
+    "build:lib": "tsup src/index.ts --format cjs,esm --dts --out-dir dist --clean",
+    "build:cdn": "tsup src/browser.ts --format iife --global-name KryptonAnalytics --minify --out-dir dist",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --out-dir dist --watch"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "rrweb-snapshot": "^2.0.0-alpha.4"
+  }
+}