@krest/sdk-web 0.0.0-stage → 0.1.0

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var a=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var p=(o,e)=>{for(var t in e)a(o,t,{get:e[t],enumerable:!0})},h=(o,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of l(e))!c.call(o,n)&&n!==t&&a(o,n,{get:()=>e[n],enumerable:!(i=d(e,n))||i.enumerable});return o};var f=o=>h(a({},"__esModule",{value:!0}),o);var w={};p(w,{default:()=>g,krest:()=>u});module.exports=f(w);var s=class{constructor(){this.config=null;this.queue=[];this.timer=null;this.spaHooked=!1;this.lastPath=""}init(e){if(!(typeof window>"u")){if(!e.publicKey||!e.endpoint)throw new Error("@krest/sdk-web: publicKey and endpoint are required");e.respectDnt&&navigator.doNotTrack==="1"||(this.config={autoTrackPageviews:!0,respectDnt:!1,flushIntervalMs:1500,...e,endpoint:e.endpoint.replace(/\/+$/,"")},this.config.autoTrackPageviews&&(this.trackPageview(),this.hookSpaNavigation()),window.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flush(!0)}),window.addEventListener("pagehide",()=>this.flush(!0)))}}trackPageview(e){if(typeof window>"u"||!this.config)return;let t=e||window.location.pathname||"/";if(t===this.lastPath&&!e)return;this.lastPath=t;let i=new URLSearchParams(window.location.search),n;if(document.referrer)try{let r=new URL(document.referrer);r.hostname!==window.location.hostname&&(n=r.hostname)}catch{}this.enqueue({eventType:"pageview",path:t,referrerDomain:n,utmSource:i.get("utm_source")||void 0,utmMedium:i.get("utm_medium")||void 0,utmCampaign:i.get("utm_campaign")||void 0})}trackEvent(e,t){typeof window>"u"||!this.config||this.enqueue({eventType:"custom",eventName:e,path:window.location.pathname||"/",properties:t})}trackWalletConnect(e){typeof window>"u"||!this.config||this.enqueue({eventType:"wallet_connect",eventName:"wallet_connect",path:window.location.pathname||"/",walletName:e.walletName,network:e.network||"mainnet"})}trackTx(e){typeof window>"u"||!this.config||this.enqueue({eventType:"tx_funnel",eventName:`tx_${e.stage}`,path:window.location.pathname||"/",txStage:e.stage,network:e.network||"mainnet",contractId:e.contractId,properties:e.properties})}flush(e=!1){if(!this.config||this.queue.length===0)return;this.timer&&(clearTimeout(this.timer),this.timer=null);let t=this.queue.splice(0,20),i=`${this.config.endpoint}/v1/ingest/web`,n=JSON.stringify({publicKey:this.config.publicKey,events:t});if(e&&typeof navigator.sendBeacon=="function"){let r=new Blob([n],{type:"application/json"});if(navigator.sendBeacon(i,r))return}fetch(i,{method:"POST",headers:{"Content-Type":"application/json","x-krest-key":this.config.publicKey},body:n,keepalive:!0,mode:"cors"}).catch(()=>{})}enqueue(e){if(this.queue.push(e),this.queue.length>=20){this.flush(!1);return}this.timer||(this.timer=setTimeout(()=>this.flush(!1),this.config?.flushIntervalMs??1500))}hookSpaNavigation(){if(this.spaHooked||typeof window>"u")return;this.spaHooked=!0;let e=history.pushState.bind(history);history.pushState=(...t)=>{e(...t),this.trackPageview()},window.addEventListener("popstate",()=>{this.trackPageview()})}},u=new s,g=u;0&&(module.exports={krest});

package/dist/index.d.cts

@@ -0,0 +1,49 @@
+type StellarNetwork = "mainnet" | "testnet" | "futurenet" | "standalone";
+type TxStage = "initiated" | "signed" | "submitted" | "confirmed" | "failed";
+interface KrestConfig {
+    publicKey: string;
+    endpoint: string;
+    autoTrackPageviews?: boolean;
+    respectDnt?: boolean;
+    flushIntervalMs?: number;
+}
+interface WebEventPayload {
+    eventType: "pageview" | "custom" | "wallet_connect" | "tx_funnel";
+    eventName?: string;
+    path: string;
+    referrerDomain?: string;
+    utmSource?: string;
+    utmMedium?: string;
+    utmCampaign?: string;
+    walletName?: string;
+    network?: StellarNetwork;
+    txStage?: TxStage;
+    contractId?: string;
+    properties?: Record<string, string | number | boolean>;
+}
+declare class KrestClient {
+    private config;
+    private queue;
+    private timer;
+    private spaHooked;
+    private lastPath;
+    init(config: KrestConfig): void;
+    trackPageview(customPath?: string): void;
+    trackEvent(eventName: string, properties?: Record<string, string | number | boolean>): void;
+    trackWalletConnect(params: {
+        walletName: string;
+        network?: StellarNetwork;
+    }): void;
+    trackTx(params: {
+        stage: TxStage;
+        network?: StellarNetwork;
+        contractId?: string;
+        properties?: Record<string, string | number | boolean>;
+    }): void;
+    flush(useBeacon?: boolean): void;
+    private enqueue;
+    private hookSpaNavigation;
+}
+declare const krest: KrestClient;
+
+export { type KrestConfig, type StellarNetwork, type TxStage, type WebEventPayload, krest as default, krest };

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+type StellarNetwork = "mainnet" | "testnet" | "futurenet" | "standalone";
+type TxStage = "initiated" | "signed" | "submitted" | "confirmed" | "failed";
+interface KrestConfig {
+    publicKey: string;
+    endpoint: string;
+    autoTrackPageviews?: boolean;
+    respectDnt?: boolean;
+    flushIntervalMs?: number;
+}
+interface WebEventPayload {
+    eventType: "pageview" | "custom" | "wallet_connect" | "tx_funnel";
+    eventName?: string;
+    path: string;
+    referrerDomain?: string;
+    utmSource?: string;
+    utmMedium?: string;
+    utmCampaign?: string;
+    walletName?: string;
+    network?: StellarNetwork;
+    txStage?: TxStage;
+    contractId?: string;
+    properties?: Record<string, string | number | boolean>;
+}
+declare class KrestClient {
+    private config;
+    private queue;
+    private timer;
+    private spaHooked;
+    private lastPath;
+    init(config: KrestConfig): void;
+    trackPageview(customPath?: string): void;
+    trackEvent(eventName: string, properties?: Record<string, string | number | boolean>): void;
+    trackWalletConnect(params: {
+        walletName: string;
+        network?: StellarNetwork;
+    }): void;
+    trackTx(params: {
+        stage: TxStage;
+        network?: StellarNetwork;
+        contractId?: string;
+        properties?: Record<string, string | number | boolean>;
+    }): void;
+    flush(useBeacon?: boolean): void;
+    private enqueue;
+    private hookSpaNavigation;
+}
+declare const krest: KrestClient;
+
+export { type KrestConfig, type StellarNetwork, type TxStage, type WebEventPayload, krest as default, krest };

package/dist/index.js

@@ -0,0 +1 @@
+var r=class{constructor(){this.config=null;this.queue=[];this.timer=null;this.spaHooked=!1;this.lastPath=""}init(e){if(!(typeof window>"u")){if(!e.publicKey||!e.endpoint)throw new Error("@krest/sdk-web: publicKey and endpoint are required");e.respectDnt&&navigator.doNotTrack==="1"||(this.config={autoTrackPageviews:!0,respectDnt:!1,flushIntervalMs:1500,...e,endpoint:e.endpoint.replace(/\/+$/,"")},this.config.autoTrackPageviews&&(this.trackPageview(),this.hookSpaNavigation()),window.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flush(!0)}),window.addEventListener("pagehide",()=>this.flush(!0)))}}trackPageview(e){if(typeof window>"u"||!this.config)return;let t=e||window.location.pathname||"/";if(t===this.lastPath&&!e)return;this.lastPath=t;let n=new URLSearchParams(window.location.search),i;if(document.referrer)try{let o=new URL(document.referrer);o.hostname!==window.location.hostname&&(i=o.hostname)}catch{}this.enqueue({eventType:"pageview",path:t,referrerDomain:i,utmSource:n.get("utm_source")||void 0,utmMedium:n.get("utm_medium")||void 0,utmCampaign:n.get("utm_campaign")||void 0})}trackEvent(e,t){typeof window>"u"||!this.config||this.enqueue({eventType:"custom",eventName:e,path:window.location.pathname||"/",properties:t})}trackWalletConnect(e){typeof window>"u"||!this.config||this.enqueue({eventType:"wallet_connect",eventName:"wallet_connect",path:window.location.pathname||"/",walletName:e.walletName,network:e.network||"mainnet"})}trackTx(e){typeof window>"u"||!this.config||this.enqueue({eventType:"tx_funnel",eventName:`tx_${e.stage}`,path:window.location.pathname||"/",txStage:e.stage,network:e.network||"mainnet",contractId:e.contractId,properties:e.properties})}flush(e=!1){if(!this.config||this.queue.length===0)return;this.timer&&(clearTimeout(this.timer),this.timer=null);let t=this.queue.splice(0,20),n=`${this.config.endpoint}/v1/ingest/web`,i=JSON.stringify({publicKey:this.config.publicKey,events:t});if(e&&typeof navigator.sendBeacon=="function"){let o=new Blob([i],{type:"application/json"});if(navigator.sendBeacon(n,o))return}fetch(n,{method:"POST",headers:{"Content-Type":"application/json","x-krest-key":this.config.publicKey},body:i,keepalive:!0,mode:"cors"}).catch(()=>{})}enqueue(e){if(this.queue.push(e),this.queue.length>=20){this.flush(!1);return}this.timer||(this.timer=setTimeout(()=>this.flush(!1),this.config?.flushIntervalMs??1500))}hookSpaNavigation(){if(this.spaHooked||typeof window>"u")return;this.spaHooked=!0;let e=history.pushState.bind(history);history.pushState=(...t)=>{e(...t),this.trackPageview()},window.addEventListener("popstate",()=>{this.trackPageview()})}},a=new r,d=a;export{d as default,a as krest};

package/dist/krest.global.js

@@ -0,0 +1 @@
+"use strict";var KrestAnalytics=(()=>{var s=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var p=(i,e)=>{for(var n in e)s(i,n,{get:e[n],enumerable:!0})},f=(i,e,n,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of d(e))!l.call(i,t)&&t!==n&&s(i,t,{get:()=>e[t],enumerable:!(r=c(e,t))||r.enumerable});return i};var h=i=>f(s({},"__esModule",{value:!0}),i);var g={};p(g,{krest:()=>a});var u=class{constructor(){this.config=null;this.queue=[];this.timer=null;this.spaHooked=!1;this.lastPath=""}init(e){if(!(typeof window>"u")){if(!e.publicKey||!e.endpoint)throw new Error("@krest/sdk-web: publicKey and endpoint are required");e.respectDnt&&navigator.doNotTrack==="1"||(this.config={autoTrackPageviews:!0,respectDnt:!1,flushIntervalMs:1500,...e,endpoint:e.endpoint.replace(/\/+$/,"")},this.config.autoTrackPageviews&&(this.trackPageview(),this.hookSpaNavigation()),window.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flush(!0)}),window.addEventListener("pagehide",()=>this.flush(!0)))}}trackPageview(e){if(typeof window>"u"||!this.config)return;let n=e||window.location.pathname||"/";if(n===this.lastPath&&!e)return;this.lastPath=n;let r=new URLSearchParams(window.location.search),t;if(document.referrer)try{let o=new URL(document.referrer);o.hostname!==window.location.hostname&&(t=o.hostname)}catch{}this.enqueue({eventType:"pageview",path:n,referrerDomain:t,utmSource:r.get("utm_source")||void 0,utmMedium:r.get("utm_medium")||void 0,utmCampaign:r.get("utm_campaign")||void 0})}trackEvent(e,n){typeof window>"u"||!this.config||this.enqueue({eventType:"custom",eventName:e,path:window.location.pathname||"/",properties:n})}trackWalletConnect(e){typeof window>"u"||!this.config||this.enqueue({eventType:"wallet_connect",eventName:"wallet_connect",path:window.location.pathname||"/",walletName:e.walletName,network:e.network||"mainnet"})}trackTx(e){typeof window>"u"||!this.config||this.enqueue({eventType:"tx_funnel",eventName:`tx_${e.stage}`,path:window.location.pathname||"/",txStage:e.stage,network:e.network||"mainnet",contractId:e.contractId,properties:e.properties})}flush(e=!1){if(!this.config||this.queue.length===0)return;this.timer&&(clearTimeout(this.timer),this.timer=null);let n=this.queue.splice(0,20),r=`${this.config.endpoint}/v1/ingest/web`,t=JSON.stringify({publicKey:this.config.publicKey,events:n});if(e&&typeof navigator.sendBeacon=="function"){let o=new Blob([t],{type:"application/json"});if(navigator.sendBeacon(r,o))return}fetch(r,{method:"POST",headers:{"Content-Type":"application/json","x-krest-key":this.config.publicKey},body:t,keepalive:!0,mode:"cors"}).catch(()=>{})}enqueue(e){if(this.queue.push(e),this.queue.length>=20){this.flush(!1);return}this.timer||(this.timer=setTimeout(()=>this.flush(!1),this.config?.flushIntervalMs??1500))}hookSpaNavigation(){if(this.spaHooked||typeof window>"u")return;this.spaHooked=!0;let e=history.pushState.bind(history);history.pushState=(...n)=>{e(...n),this.trackPageview()},window.addEventListener("popstate",()=>{this.trackPageview()})}},a=new u;if(typeof document<"u"){let i=document.currentScript||document.querySelector("script[data-krest-key]");if(i){let e=i.getAttribute("data-krest-key"),n=i.getAttribute("data-krest-endpoint"),r=i.getAttribute("data-krest-dnt")==="true",t=n||"";if(!t&&i.src)try{t=new URL(i.src).origin}catch{t=""}e&&t&&(a.init({publicKey:e,endpoint:t,respectDnt:r}),window.krest=a)}}return h(g);})();

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@krest/sdk-web",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Privacy-first Web and Stellar dApp analytics SDK",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KELLON-RWA/Krest.git",
+    "directory": "packages/sdk-web"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.