@inferevents/sdk 0.1.0

package/dist/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var h=false;function E(t){h=t;}function a(t,...e){h&&console.log(`[infer] ${t}`,...e);}function g(t,...e){h&&console.warn(`[infer] ${t}`,...e);}function S(t,...e){h&&console.error(`[infer] ${t}`,...e);}var b="infer_event_queue",p=1e3,i=[];function _(){try{return typeof localStorage<"u"?localStorage:null}catch{return null}}function T(t){i.length>=p&&(g("Queue full, dropping oldest event"),i.shift()),i.push(t),a(`Queued event: ${t.event_name} (${i.length} in queue)`);}function I(t){return i.splice(0,t)}function m(){return i.length}function l(t){i=[...t,...i],i.length>p&&(i=i.slice(i.length-p));}function d(){let t=_();if(!(!t||i.length===0))try{t.setItem(b,JSON.stringify(i)),a("Persisted queue to localStorage:",i.length);}catch{}}function C(){let t=_();if(t)try{let e=t.getItem(b);if(e){let n=JSON.parse(e);Array.isArray(n)&&(i=[...n,...i],i.length>p&&(i=i.slice(i.length-p)),a("Restored queue from localStorage:",n.length)),t.removeItem(b);}}catch{}}var D="0.1.0";function O(){return typeof window<"u"&&typeof document<"u"}function x(){let t={platform:"web",sdk_version:D};if(!O())return t;typeof navigator<"u"&&(t.browser=navigator.userAgent,t.locale=navigator.language),typeof screen<"u"&&(t.screen_width=screen.width,t.screen_height=screen.height);try{t.timezone=Intl.DateTimeFormat().resolvedOptions().timeZone;}catch{}return t.page_url=window.location.href,t.page_title=document.title,t}var k="infer_anonymous_id",u=null,y=null,v={};function A(){try{return typeof localStorage<"u"?localStorage:null}catch{return null}}function R(){if(u)return u;let t=A();if(t){let e=t.getItem(k);if(e)return u=e,u}if(u=crypto.randomUUID(),a("Generated anonymous_id:",u),t)try{t.setItem(k,u);}catch{}return u}function L(){return y}function N(t,e){y=t,e&&(v={...v,...e}),a("Identity set:",y,v);}function M(){y=null,v={},u=null;let t=A();if(t)try{t.removeItem(k);}catch{}}var U="infer_session_last_active";var Q={pageView:true,session:true,click:true,formSubmit:true,error:true};function j(t){return t===false?null:t===true?{...Q}:{...Q,...t}}function q(t,e){if(typeof window>"u")return ()=>{};let n=[];return e.session&&$(t),e.pageView&&n.push(z(t)),e.click&&n.push(P(t)),e.formSubmit&&n.push(B(t)),e.error&&n.push(F(t)),()=>{for(let r of n)r();}}function $(t){try{let e=Date.now(),n=sessionStorage.getItem(U);(!n||e-Number(n)>18e5)&&t.trackInternal("session_start",{}),sessionStorage.setItem(U,String(e));}catch{}}function z(t){t.trackInternal("page_view",{url:window.location.href,path:window.location.pathname,title:document.title});let e=history.pushState.bind(history),n=history.replaceState.bind(history),r=()=>{t.trackInternal("page_view",{url:window.location.href,path:window.location.pathname,title:document.title});};return history.pushState=function(...o){e(...o),r();},history.replaceState=function(...o){n(...o),r();},window.addEventListener("popstate",r),()=>{history.pushState=e,history.replaceState=n,window.removeEventListener("popstate",r);}}function P(t){let e=n=>{let r=n.target;if(!r)return;let o=r.closest("a, button, [role='button'], input[type='submit']");if(!o)return;let c={tag:o.tagName.toLowerCase()};o.id&&(c.element_id=o.id),o.className&&typeof o.className=="string"&&(c.element_class=o.className),o.tagName==="A"&&(c.href=o.href),t.trackInternal("click",c);};return document.addEventListener("click",e,{capture:true}),()=>document.removeEventListener("click",e,{capture:true})}function B(t){let e=n=>{let r=n.target;if(!r)return;let o={};r.id&&(o.form_id=r.id),r.action&&(o.form_action=r.action),r.method&&(o.form_method=r.method.toUpperCase()),t.trackInternal("form_submit",o);};return document.addEventListener("submit",e,{capture:true}),()=>document.removeEventListener("submit",e,{capture:true})}function F(t){let e=r=>{t.trackInternal("error",{message:r.message||"Unknown error",filename:r.filename||null,lineno:r.lineno||null,colno:r.colno||null});},n=r=>{let o=r.reason instanceof Error?r.reason.message:typeof r.reason=="string"?r.reason:"Unhandled promise rejection";t.trackInternal("error",{message:o,type:"unhandledrejection"});};return window.addEventListener("error",e),window.addEventListener("unhandledrejection",n),()=>{window.removeEventListener("error",e),window.removeEventListener("unhandledrejection",n);}}var Y="https://api.infer.events",V=20,H=1e4,J=3e4,K=1e3,w=class{config;flushTimer=null;teardownAutoTrack=null;flushing=false;retryCount=0;constructor(e){if(!e.projectId||typeof e.projectId!="string")throw new Error("[infer] projectId is required");if(E(e.debug??false),this.config={projectId:e.projectId,endpoint:e.endpoint??Y,batchSize:e.batchSize??V,flushInterval:e.flushInterval??H},a("Initialized with config:",this.config),C(),this.flushTimer=setInterval(()=>{this.flush();},this.config.flushInterval),typeof window<"u"){let r=()=>{d(),this.sendBeacon();};window.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&r();}),window.addEventListener("pagehide",r);}let n=j(e.autoTrack??false);n&&(this.teardownAutoTrack=q(this,n));}track(e,n){this.enqueueEvent("track",e,n??{});}identify(e,n){N(e,n),this.enqueueEvent("identify","identify",n??{});}page(e){let n={};e&&(n.name=e),typeof window<"u"&&(n.url=window.location.href,n.path=window.location.pathname,n.title=document.title),this.enqueueEvent("page","page_view",n);}screen(e){this.enqueueEvent("screen","screen_view",{name:e});}trackInternal(e,n){this.enqueueEvent("track",e,n);}async flush(){if(this.flushing||m()===0)return;this.flushing=true;let e=I(this.config.batchSize);a(`Flushing ${e.length} events`);try{let n=await fetch(`${this.config.endpoint}/v1/events`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({events:e})});n.ok?(this.retryCount=0,a(`Flushed ${e.length} events successfully`)):n.status>=500?(g(`Server error ${n.status}, will retry`),l(e),this.scheduleRetry()):S(`Client error ${n.status}, dropping batch`);}catch(n){g("Network error, will retry:",n),l(e),this.scheduleRetry();}finally{this.flushing=false;}m()>0&&this.flush();}destroy(){this.flushTimer&&(clearInterval(this.flushTimer),this.flushTimer=null),this.teardownAutoTrack&&(this.teardownAutoTrack(),this.teardownAutoTrack=null),d();}enqueueEvent(e,n,r){let o={event_id:crypto.randomUUID(),project_id:this.config.projectId,anonymous_id:R(),event_name:n,event_type:e,properties:r,context:x(),timestamp:new Date().toISOString()},c=L();c&&(o.user_id=c),T(o),m()>=this.config.batchSize&&this.flush();}sendBeacon(){let e=I(this.config.batchSize);if(e.length!==0)try{if(typeof navigator<"u"&&navigator.sendBeacon){let n=new Blob([JSON.stringify({events:e})],{type:"application/json"});navigator.sendBeacon(`${this.config.endpoint}/v1/events`,n)?a(`Beacon sent ${e.length} events`):(l(e),d());}else l(e),d();}catch{l(e),d();}}scheduleRetry(){this.retryCount++;let e=Math.min(K*Math.pow(2,this.retryCount-1)+Math.random()*1e3,J);a(`Retry #${this.retryCount} in ${Math.round(e)}ms`),setTimeout(()=>{this.flush();},e);}};var s=null,f=[];function le(t){s&&s.destroy(),s=new w(t);for(let e of f)switch(e.type){case "track":s.track(...e.args);break;case "identify":s.identify(...e.args);break;case "page":s.page(...e.args);break;case "screen":s.screen(...e.args);break}return f=[],s}function de(t,e){if(!s){f.push({type:"track",args:[t,e]});return}s.track(t,e);}function fe(t,e){if(!s){f.push({type:"identify",args:[t,e]});return}s.identify(t,e);}function ge(t){if(!s){f.push({type:"page",args:[t]});return}s.page(t);}function pe(t){if(!s){f.push({type:"screen",args:[t]});return}s.screen(t);}async function he(){s&&await s.flush();}function me(){s&&(s.destroy(),s=null);}
+exports.destroy=me;exports.flush=he;exports.identify=fe;exports.init=le;exports.page=ge;exports.reset=M;exports.screen=pe;exports.track=de;

package/dist/index.d.cts

@@ -0,0 +1,81 @@
+interface AutoTrackConfig {
+    pageView: boolean;
+    session: boolean;
+    click: boolean;
+    formSubmit: boolean;
+    error: boolean;
+}
+
+interface InferConfig {
+    projectId: string;
+    endpoint?: string;
+    autoTrack?: boolean | Partial<AutoTrackConfig>;
+    batchSize?: number;
+    flushInterval?: number;
+    debug?: boolean;
+}
+declare class InferClient {
+    private config;
+    private flushTimer;
+    private teardownAutoTrack;
+    private flushing;
+    private retryCount;
+    constructor(config: InferConfig);
+    track(eventName: string, properties?: Record<string, string | number | boolean | null>): void;
+    identify(newUserId: string, traits?: Record<string, string | number | boolean | null>): void;
+    page(name?: string): void;
+    screen(name: string): void;
+    /** Internal method for auto-tracking — do not use directly. */
+    trackInternal(eventName: string, properties: Record<string, string | number | boolean | null>): void;
+    flush(): Promise<void>;
+    destroy(): void;
+    private enqueueEvent;
+    private sendBeacon;
+    private scheduleRetry;
+}
+
+interface QueuedEvent {
+    event_id: string;
+    project_id: string;
+    user_id?: string;
+    anonymous_id: string;
+    event_name: string;
+    event_type: "track" | "identify" | "page" | "screen";
+    properties: Record<string, string | number | boolean | null>;
+    context: Record<string, unknown>;
+    timestamp: string;
+}
+
+declare function resetIdentity(): void;
+
+/**
+ * Initialize the Infer SDK. Must be called before tracking events.
+ * Events queued before init() will be replayed automatically.
+ */
+declare function init(config: InferConfig): InferClient;
+/**
+ * Track a custom event.
+ */
+declare function track(eventName: string, properties?: Record<string, string | number | boolean | null>): void;
+/**
+ * Identify a user and link to anonymous_id.
+ */
+declare function identify(userId: string, traits?: Record<string, string | number | boolean | null>): void;
+/**
+ * Track a page view. Optionally provide a page name.
+ */
+declare function page(name?: string): void;
+/**
+ * Track a screen view (for React Native / mobile).
+ */
+declare function screen(name: string): void;
+/**
+ * Manually flush the event queue.
+ */
+declare function flush(): Promise<void>;
+/**
+ * Destroy the client and clean up timers/listeners.
+ */
+declare function destroy(): void;
+
+export { type AutoTrackConfig, InferClient, type InferConfig, type QueuedEvent, destroy, flush, identify, init, page, resetIdentity as reset, screen, track };

package/dist/index.d.ts

@@ -0,0 +1,81 @@
+interface AutoTrackConfig {
+    pageView: boolean;
+    session: boolean;
+    click: boolean;
+    formSubmit: boolean;
+    error: boolean;
+}
+
+interface InferConfig {
+    projectId: string;
+    endpoint?: string;
+    autoTrack?: boolean | Partial<AutoTrackConfig>;
+    batchSize?: number;
+    flushInterval?: number;
+    debug?: boolean;
+}
+declare class InferClient {
+    private config;
+    private flushTimer;
+    private teardownAutoTrack;
+    private flushing;
+    private retryCount;
+    constructor(config: InferConfig);
+    track(eventName: string, properties?: Record<string, string | number | boolean | null>): void;
+    identify(newUserId: string, traits?: Record<string, string | number | boolean | null>): void;
+    page(name?: string): void;
+    screen(name: string): void;
+    /** Internal method for auto-tracking — do not use directly. */
+    trackInternal(eventName: string, properties: Record<string, string | number | boolean | null>): void;
+    flush(): Promise<void>;
+    destroy(): void;
+    private enqueueEvent;
+    private sendBeacon;
+    private scheduleRetry;
+}
+
+interface QueuedEvent {
+    event_id: string;
+    project_id: string;
+    user_id?: string;
+    anonymous_id: string;
+    event_name: string;
+    event_type: "track" | "identify" | "page" | "screen";
+    properties: Record<string, string | number | boolean | null>;
+    context: Record<string, unknown>;
+    timestamp: string;
+}
+
+declare function resetIdentity(): void;
+
+/**
+ * Initialize the Infer SDK. Must be called before tracking events.
+ * Events queued before init() will be replayed automatically.
+ */
+declare function init(config: InferConfig): InferClient;
+/**
+ * Track a custom event.
+ */
+declare function track(eventName: string, properties?: Record<string, string | number | boolean | null>): void;
+/**
+ * Identify a user and link to anonymous_id.
+ */
+declare function identify(userId: string, traits?: Record<string, string | number | boolean | null>): void;
+/**
+ * Track a page view. Optionally provide a page name.
+ */
+declare function page(name?: string): void;
+/**
+ * Track a screen view (for React Native / mobile).
+ */
+declare function screen(name: string): void;
+/**
+ * Manually flush the event queue.
+ */
+declare function flush(): Promise<void>;
+/**
+ * Destroy the client and clean up timers/listeners.
+ */
+declare function destroy(): void;
+
+export { type AutoTrackConfig, InferClient, type InferConfig, type QueuedEvent, destroy, flush, identify, init, page, resetIdentity as reset, screen, track };

package/dist/index.js

@@ -0,0 +1,2 @@
+var h=false;function E(t){h=t;}function a(t,...e){h&&console.log(`[infer] ${t}`,...e);}function g(t,...e){h&&console.warn(`[infer] ${t}`,...e);}function S(t,...e){h&&console.error(`[infer] ${t}`,...e);}var b="infer_event_queue",p=1e3,i=[];function _(){try{return typeof localStorage<"u"?localStorage:null}catch{return null}}function T(t){i.length>=p&&(g("Queue full, dropping oldest event"),i.shift()),i.push(t),a(`Queued event: ${t.event_name} (${i.length} in queue)`);}function I(t){return i.splice(0,t)}function m(){return i.length}function l(t){i=[...t,...i],i.length>p&&(i=i.slice(i.length-p));}function d(){let t=_();if(!(!t||i.length===0))try{t.setItem(b,JSON.stringify(i)),a("Persisted queue to localStorage:",i.length);}catch{}}function C(){let t=_();if(t)try{let e=t.getItem(b);if(e){let n=JSON.parse(e);Array.isArray(n)&&(i=[...n,...i],i.length>p&&(i=i.slice(i.length-p)),a("Restored queue from localStorage:",n.length)),t.removeItem(b);}}catch{}}var D="0.1.0";function O(){return typeof window<"u"&&typeof document<"u"}function x(){let t={platform:"web",sdk_version:D};if(!O())return t;typeof navigator<"u"&&(t.browser=navigator.userAgent,t.locale=navigator.language),typeof screen<"u"&&(t.screen_width=screen.width,t.screen_height=screen.height);try{t.timezone=Intl.DateTimeFormat().resolvedOptions().timeZone;}catch{}return t.page_url=window.location.href,t.page_title=document.title,t}var k="infer_anonymous_id",u=null,y=null,v={};function A(){try{return typeof localStorage<"u"?localStorage:null}catch{return null}}function R(){if(u)return u;let t=A();if(t){let e=t.getItem(k);if(e)return u=e,u}if(u=crypto.randomUUID(),a("Generated anonymous_id:",u),t)try{t.setItem(k,u);}catch{}return u}function L(){return y}function N(t,e){y=t,e&&(v={...v,...e}),a("Identity set:",y,v);}function M(){y=null,v={},u=null;let t=A();if(t)try{t.removeItem(k);}catch{}}var U="infer_session_last_active";var Q={pageView:true,session:true,click:true,formSubmit:true,error:true};function j(t){return t===false?null:t===true?{...Q}:{...Q,...t}}function q(t,e){if(typeof window>"u")return ()=>{};let n=[];return e.session&&$(t),e.pageView&&n.push(z(t)),e.click&&n.push(P(t)),e.formSubmit&&n.push(B(t)),e.error&&n.push(F(t)),()=>{for(let r of n)r();}}function $(t){try{let e=Date.now(),n=sessionStorage.getItem(U);(!n||e-Number(n)>18e5)&&t.trackInternal("session_start",{}),sessionStorage.setItem(U,String(e));}catch{}}function z(t){t.trackInternal("page_view",{url:window.location.href,path:window.location.pathname,title:document.title});let e=history.pushState.bind(history),n=history.replaceState.bind(history),r=()=>{t.trackInternal("page_view",{url:window.location.href,path:window.location.pathname,title:document.title});};return history.pushState=function(...o){e(...o),r();},history.replaceState=function(...o){n(...o),r();},window.addEventListener("popstate",r),()=>{history.pushState=e,history.replaceState=n,window.removeEventListener("popstate",r);}}function P(t){let e=n=>{let r=n.target;if(!r)return;let o=r.closest("a, button, [role='button'], input[type='submit']");if(!o)return;let c={tag:o.tagName.toLowerCase()};o.id&&(c.element_id=o.id),o.className&&typeof o.className=="string"&&(c.element_class=o.className),o.tagName==="A"&&(c.href=o.href),t.trackInternal("click",c);};return document.addEventListener("click",e,{capture:true}),()=>document.removeEventListener("click",e,{capture:true})}function B(t){let e=n=>{let r=n.target;if(!r)return;let o={};r.id&&(o.form_id=r.id),r.action&&(o.form_action=r.action),r.method&&(o.form_method=r.method.toUpperCase()),t.trackInternal("form_submit",o);};return document.addEventListener("submit",e,{capture:true}),()=>document.removeEventListener("submit",e,{capture:true})}function F(t){let e=r=>{t.trackInternal("error",{message:r.message||"Unknown error",filename:r.filename||null,lineno:r.lineno||null,colno:r.colno||null});},n=r=>{let o=r.reason instanceof Error?r.reason.message:typeof r.reason=="string"?r.reason:"Unhandled promise rejection";t.trackInternal("error",{message:o,type:"unhandledrejection"});};return window.addEventListener("error",e),window.addEventListener("unhandledrejection",n),()=>{window.removeEventListener("error",e),window.removeEventListener("unhandledrejection",n);}}var Y="https://api.infer.events",V=20,H=1e4,J=3e4,K=1e3,w=class{config;flushTimer=null;teardownAutoTrack=null;flushing=false;retryCount=0;constructor(e){if(!e.projectId||typeof e.projectId!="string")throw new Error("[infer] projectId is required");if(E(e.debug??false),this.config={projectId:e.projectId,endpoint:e.endpoint??Y,batchSize:e.batchSize??V,flushInterval:e.flushInterval??H},a("Initialized with config:",this.config),C(),this.flushTimer=setInterval(()=>{this.flush();},this.config.flushInterval),typeof window<"u"){let r=()=>{d(),this.sendBeacon();};window.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&r();}),window.addEventListener("pagehide",r);}let n=j(e.autoTrack??false);n&&(this.teardownAutoTrack=q(this,n));}track(e,n){this.enqueueEvent("track",e,n??{});}identify(e,n){N(e,n),this.enqueueEvent("identify","identify",n??{});}page(e){let n={};e&&(n.name=e),typeof window<"u"&&(n.url=window.location.href,n.path=window.location.pathname,n.title=document.title),this.enqueueEvent("page","page_view",n);}screen(e){this.enqueueEvent("screen","screen_view",{name:e});}trackInternal(e,n){this.enqueueEvent("track",e,n);}async flush(){if(this.flushing||m()===0)return;this.flushing=true;let e=I(this.config.batchSize);a(`Flushing ${e.length} events`);try{let n=await fetch(`${this.config.endpoint}/v1/events`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({events:e})});n.ok?(this.retryCount=0,a(`Flushed ${e.length} events successfully`)):n.status>=500?(g(`Server error ${n.status}, will retry`),l(e),this.scheduleRetry()):S(`Client error ${n.status}, dropping batch`);}catch(n){g("Network error, will retry:",n),l(e),this.scheduleRetry();}finally{this.flushing=false;}m()>0&&this.flush();}destroy(){this.flushTimer&&(clearInterval(this.flushTimer),this.flushTimer=null),this.teardownAutoTrack&&(this.teardownAutoTrack(),this.teardownAutoTrack=null),d();}enqueueEvent(e,n,r){let o={event_id:crypto.randomUUID(),project_id:this.config.projectId,anonymous_id:R(),event_name:n,event_type:e,properties:r,context:x(),timestamp:new Date().toISOString()},c=L();c&&(o.user_id=c),T(o),m()>=this.config.batchSize&&this.flush();}sendBeacon(){let e=I(this.config.batchSize);if(e.length!==0)try{if(typeof navigator<"u"&&navigator.sendBeacon){let n=new Blob([JSON.stringify({events:e})],{type:"application/json"});navigator.sendBeacon(`${this.config.endpoint}/v1/events`,n)?a(`Beacon sent ${e.length} events`):(l(e),d());}else l(e),d();}catch{l(e),d();}}scheduleRetry(){this.retryCount++;let e=Math.min(K*Math.pow(2,this.retryCount-1)+Math.random()*1e3,J);a(`Retry #${this.retryCount} in ${Math.round(e)}ms`),setTimeout(()=>{this.flush();},e);}};var s=null,f=[];function le(t){s&&s.destroy(),s=new w(t);for(let e of f)switch(e.type){case "track":s.track(...e.args);break;case "identify":s.identify(...e.args);break;case "page":s.page(...e.args);break;case "screen":s.screen(...e.args);break}return f=[],s}function de(t,e){if(!s){f.push({type:"track",args:[t,e]});return}s.track(t,e);}function fe(t,e){if(!s){f.push({type:"identify",args:[t,e]});return}s.identify(t,e);}function ge(t){if(!s){f.push({type:"page",args:[t]});return}s.page(t);}function pe(t){if(!s){f.push({type:"screen",args:[t]});return}s.screen(t);}async function he(){s&&await s.flush();}function me(){s&&(s.destroy(),s=null);}
+export{me as destroy,he as flush,fe as identify,le as init,ge as page,M as reset,pe as screen,de as track};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@inferevents/sdk",
+  "version": "0.1.0",
+  "description": "Lightweight JavaScript SDK for Infer analytics",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup": "^8",
+    "typescript": "^5.7"
+  },
+  "sideEffects": false,
+  "license": "MIT"
+}