@tekibo/feedpulse-sdk 2.0.1 → 2.1.1

package/README.md

@@ -21,35 +21,6 @@ The SDK automatically tracks:
 - `scroll_into_view`: when tagged elements enter viewport
 - `feedback`: explicit rating/message submissions from widget or manual API
 
-Each event includes context such as session id, visitor id, page path, device, browser, OS, metadata, and timestamp.
-
-## Backend requirements
-
-Your backend must expose an ingest endpoint compatible with this payload:
-
-```json
-{
-  "events": [
-    {
-      "projectApiKey": "fp_live_xxx",
-      "elementId": "hero-cta",
-      "eventType": "click",
-      "sessionId": "session-1",
-      "visitorId": "visitor-1",
-      "page": "/",
-      "device": "desktop",
-      "metadata": {},
-      "timestamp": "2026-03-12T00:00:00.000Z"
-    }
-  ]
-}
-```
-
-In the FeedPulse codebase, the default server endpoint is:
-
-- `POST /api/ingest`
-
-## Quick start (Nuxt)
 
 Import from `@tekibo/feedpulse-sdk/nuxt` and wrap your app:
 
@@ -60,12 +31,16 @@ import { FeedPulseProvider, FeedPulseWidget } from "@tekibo/feedpulse-sdk/nuxt";
 
 <template>
   <FeedPulseProvider api-key="fp_live_your_project_key">
-    <NuxtPage />
+  <FeedPulseProvider
+    api-key="fp_live_your_project_key"
+    endpoint="https://feed-pulse.vercel.app/api/ingest"
+  >
     <FeedPulseWidget id="global-feedback" position="bottom-right" />
   </FeedPulseProvider>
 </template>
 ```
 
+
 Tag any interactive element with `data-fp-id`:
 
 ```vue
@@ -112,7 +87,10 @@ function SaveButton() {
 
 export default function App() {
   return (
-    <FeedPulseProvider apiKey="fp_live_your_project_key">
+    <FeedPulseProvider
+      apiKey="fp_live_your_project_key"
+      endpoint="https://feed-pulse.vercel.app/api/ingest"
+    >
       <button data-fp-id="hero-cta">Get Started</button>
       <SaveButton />
       <FeedPulseWidget id="global-feedback" position="bottom-right" />
@@ -132,7 +110,7 @@ import { FeedPulseTracker } from "@tekibo/feedpulse-sdk";
 `FeedPulseTracker` configuration:
 
 - `apiKey: string` required
-- `endpoint?: string` optional, defaults to `https://feedpulse.dev/api/ingest`
+- `endpoint?: string` optional, defaults to `https://feed-pulse.vercel.app/api/ingest`
 - `batchInterval?: number` optional, defaults to `5000` ms
 
 Key methods:
@@ -150,32 +128,6 @@ Nuxt and React widgets support:
 - `placeholder?: string` prompt text
 - `position?: "bottom-right" | "bottom-left" | "inline"` default is `"bottom-right"`
 
-## Endpoint override
-
-Use this when sending to staging/self-hosted backend:
-
-### Nuxt
-
-```vue
-<FeedPulseProvider
-  api-key="fp_live_your_project_key"
-  endpoint="https://staging.your-domain.com/api/ingest"
->
-  <NuxtPage />
-</FeedPulseProvider>
-```
-
-### React
-
-```tsx
-<FeedPulseProvider
-  apiKey="fp_live_your_project_key"
-  endpoint="https://staging.your-domain.com/api/ingest"
->
-  {children}
-</FeedPulseProvider>
-```
-
 ## Integration checklist for your app
 
 1. Create a project in FeedPulse dashboard and copy the project API key

package/dist/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class n{constructor(e){this.queue=[],this.flushInterval=null,this.observer=null,this.intersectionObserver=null,this.seenInView=new Set,this.config={endpoint:"https://feedpulse.dev/api/ingest",batchInterval:5e3,...e},this.visitorId=this.getOrCreateVisitorId(),this.sessionId=this.generateSessionId()}init(){this.startFlushInterval(),this.attachGlobalListeners(),this.observeDOM()}attachGlobalListeners(){document.addEventListener("click",i=>{const s=i.target.closest("[data-fp-id]");s&&this.track("click",s.getAttribute("data-fp-id"),{x:i.clientX,y:i.clientY})},{passive:!0});let e=0,t=null;document.addEventListener("mouseover",i=>{const s=i.target.closest("[data-fp-id]");s&&(e=Date.now(),t=s.getAttribute("data-fp-id"))},{passive:!0}),document.addEventListener("mouseout",i=>{if(!i.target.closest("[data-fp-id]")||!t)return;const r=Date.now()-e;r>500&&this.track("hover",t,{hoverDuration:r}),t=null},{passive:!0})}observeDOM(){this.intersectionObserver=new IntersectionObserver(t=>{for(const i of t){const s=i.target.dataset.fpId;!s||!i.isIntersecting||this.seenInView.has(s)||(this.seenInView.add(s),this.track("scroll_into_view",s,{scrollDepth:Math.round(window.scrollY/Math.max(1,document.body.scrollHeight)*100)}))}},{threshold:.5});const e=()=>{document.querySelectorAll("[data-fp-id]").forEach(t=>{this.intersectionObserver?.observe(t)})};e(),this.observer=new MutationObserver(()=>e()),this.observer.observe(document.body,{childList:!0,subtree:!0})}track(e,t,i){this.queue.push({projectApiKey:this.config.apiKey,elementId:t,eventType:e,sessionId:this.sessionId,visitorId:this.visitorId,page:window.location.pathname,referrer:document.referrer,device:this.getDeviceType(),browser:this.getBrowser(),os:this.getOS(),metadata:i,timestamp:new Date().toISOString()})}trackFeedback(e,t,i){!t&&!i||this.sendImmediate([{projectApiKey:this.config.apiKey,elementId:e??"__page__",eventType:"feedback",sessionId:this.sessionId,visitorId:this.visitorId,page:window.location.pathname,device:this.getDeviceType(),metadata:{rating:t,message:i},timestamp:new Date().toISOString()}])}async flush(){if(this.queue.length===0)return;const e=[...this.queue];this.queue=[],await this.sendImmediate(e)}async sendImmediate(e){try{await fetch(this.config.endpoint,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({events:e}),keepalive:!0})}catch{}}startFlushInterval(){this.flushInterval=setInterval(()=>this.flush(),this.config.batchInterval),window.addEventListener("beforeunload",()=>this.flush()),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flush()})}getOrCreateVisitorId(){const e="__fp_vid";let t=localStorage.getItem(e);return t||(t=crypto.randomUUID(),localStorage.setItem(e,t)),t}generateSessionId(){return`${Date.now()}-${Math.random().toString(36).slice(2)}`}getDeviceType(){const e=navigator.userAgent;return/Mobi|Android/i.test(e)?"mobile":/Tablet|iPad/i.test(e)?"tablet":"desktop"}getBrowser(){const e=navigator.userAgent;return e.includes("Edg")?"Edge":e.includes("Chrome")?"Chrome":e.includes("Firefox")?"Firefox":e.includes("Safari")?"Safari":"Other"}getOS(){const e=navigator.userAgent;return e.includes("Windows")?"Windows":e.includes("Mac")?"macOS":e.includes("Linux")?"Linux":e.includes("Android")?"Android":/iPhone|iOS/.test(e)?"iOS":"Other"}destroy(){this.flushInterval&&clearInterval(this.flushInterval),this.observer?.disconnect(),this.intersectionObserver?.disconnect(),this.flush()}}exports.FeedPulseTracker=n;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class n{constructor(e){this.queue=[],this.flushInterval=null,this.observer=null,this.intersectionObserver=null,this.seenInView=new Set,this.config={endpoint:"https://feed-pulse.vercel.app/api/ingest",batchInterval:5e3,...e},this.visitorId=this.getOrCreateVisitorId(),this.sessionId=this.generateSessionId()}init(){this.startFlushInterval(),this.attachGlobalListeners(),this.observeDOM()}attachGlobalListeners(){document.addEventListener("click",i=>{const s=i.target.closest("[data-fp-id]");s&&this.track("click",s.getAttribute("data-fp-id"),{x:i.clientX,y:i.clientY})},{passive:!0});let e=0,t=null;document.addEventListener("mouseover",i=>{const s=i.target.closest("[data-fp-id]");s&&(e=Date.now(),t=s.getAttribute("data-fp-id"))},{passive:!0}),document.addEventListener("mouseout",i=>{if(!i.target.closest("[data-fp-id]")||!t)return;const r=Date.now()-e;r>500&&this.track("hover",t,{hoverDuration:r}),t=null},{passive:!0})}observeDOM(){this.intersectionObserver=new IntersectionObserver(t=>{for(const i of t){const s=i.target.dataset.fpId;!s||!i.isIntersecting||this.seenInView.has(s)||(this.seenInView.add(s),this.track("scroll_into_view",s,{scrollDepth:Math.round(window.scrollY/Math.max(1,document.body.scrollHeight)*100)}))}},{threshold:.5});const e=()=>{document.querySelectorAll("[data-fp-id]").forEach(t=>{this.intersectionObserver?.observe(t)})};e(),this.observer=new MutationObserver(()=>e()),this.observer.observe(document.body,{childList:!0,subtree:!0})}track(e,t,i){this.queue.push({projectApiKey:this.config.apiKey,elementId:t,eventType:e,sessionId:this.sessionId,visitorId:this.visitorId,page:window.location.pathname,referrer:document.referrer,device:this.getDeviceType(),browser:this.getBrowser(),os:this.getOS(),metadata:i,timestamp:new Date().toISOString()})}trackFeedback(e,t,i){!t&&!i||this.sendImmediate([{projectApiKey:this.config.apiKey,elementId:e??"__page__",eventType:"feedback",sessionId:this.sessionId,visitorId:this.visitorId,page:window.location.pathname,device:this.getDeviceType(),metadata:{rating:t,message:i},timestamp:new Date().toISOString()}])}async flush(){if(this.queue.length===0)return;const e=[...this.queue];this.queue=[],await this.sendImmediate(e)}async sendImmediate(e){try{await fetch(this.config.endpoint,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({events:e}),keepalive:!0})}catch{}}startFlushInterval(){this.flushInterval=setInterval(()=>this.flush(),this.config.batchInterval),window.addEventListener("beforeunload",()=>this.flush()),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flush()})}getOrCreateVisitorId(){const e="__fp_vid";let t=localStorage.getItem(e);return t||(t=crypto.randomUUID(),localStorage.setItem(e,t)),t}generateSessionId(){return`${Date.now()}-${Math.random().toString(36).slice(2)}`}getDeviceType(){const e=navigator.userAgent;return/Mobi|Android/i.test(e)?"mobile":/Tablet|iPad/i.test(e)?"tablet":"desktop"}getBrowser(){const e=navigator.userAgent;return e.includes("Edg")?"Edge":e.includes("Chrome")?"Chrome":e.includes("Firefox")?"Firefox":e.includes("Safari")?"Safari":"Other"}getOS(){const e=navigator.userAgent;return e.includes("Windows")?"Windows":e.includes("Mac")?"macOS":e.includes("Linux")?"Linux":e.includes("Android")?"Android":/iPhone|iOS/.test(e)?"iOS":"Other"}destroy(){this.flushInterval&&clearInterval(this.flushInterval),this.observer?.disconnect(),this.intersectionObserver?.disconnect(),this.flush()}}exports.FeedPulseTracker=n;

package/dist/index.mjs

@@ -1,7 +1,7 @@
 class o {
   constructor(e) {
     this.queue = [], this.flushInterval = null, this.observer = null, this.intersectionObserver = null, this.seenInView = /* @__PURE__ */ new Set(), this.config = {
-      endpoint: "https://feedpulse.dev/api/ingest",
+      endpoint: "https://feed-pulse.vercel.app/api/ingest",
       batchInterval: 5e3,
       ...e
     }, this.visitorId = this.getOrCreateVisitorId(), this.sessionId = this.generateSessionId();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekibo/feedpulse-sdk",
-  "version": "2.0.1",
+  "version": "2.1.1",
   "description": "Embeddable analytics and feedback SDK for FeedPulse",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",