@indiebob/tracker 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable changes to `@indiebob/tracker` will be documented here.
+
+This project adheres to [Semantic Versioning](https://semver.org/).
+
+---
+
+## [1.0.0] — 2026-02-24
+
+### Added
+- `IndieBob.init()` factory — creates a tracker instance with config validation
+- `bob.page()` — track page views with auto-detection of URL, title, referrer
+- `bob.track()` — custom event tracking with arbitrary properties
+- `bob.identify()` — link anonymous visitors to known user IDs
+- `bob.revenue()` — track revenue events for attribution
+- `bob.optOut()` / `bob.optIn()` / `bob.isOptedOut()` — privacy controls
+- `bob.flush()` — force-send all queued events
+- `bob.getAnonymousId()`, `bob.getSessionId()`, `bob.getConfig()` — introspection
+- Event batching: auto-flush at 10 events or 5-second interval
+- `visibilitychange` flush for reliable mobile delivery
+- Offline queue via localStorage with auto-flush on reconnect
+- UTM first-touch and last-touch attribution
+- DNT (Do Not Track) and GPC (Global Privacy Control) support
+- `@indiebob/tracker/vue` — Vue plugin + `useTracker()` composable
+- `@indiebob/tracker/server` — Node.js server-side tracking
+- Browser IIFE bundle: < 5KB gzipped, zero runtime dependencies
+- Event schema v1 with `v: 1` version field for backwards compatibility

package/README.md

@@ -0,0 +1,349 @@
+# @indiebob/tracker
+
+Privacy-first analytics SDK for web applications. Under 5KB gzipped. No cookies. GDPR/CCPA/GPC compliant.
+
+## Installation
+
+```bash
+npm install @indiebob/tracker
+# or
+pnpm add @indiebob/tracker
+```
+
+Or via script tag (CDN):
+
+```html
+<script src="https://assets.indiebob.com/tracker/latest/indiebob.min.js"></script>
+```
+
+## Quick Start
+
+Three lines to start tracking:
+
+```js
+import { IndieBob } from '@indiebob/tracker'
+
+const bob = IndieBob.init({ projectId: 'proj_your16charId' })
+bob.page()
+```
+
+That's it. Page views are now tracked. UTM parameters are auto-captured.
+
+## Configuration
+
+```ts
+const bob = IndieBob.init({
+  projectId: 'proj_your16charId',  // Required. From your IndieBob dashboard.
+  endpoint: 'https://indiebob.com/api/collect',  // Optional. Default shown.
+  debug: false,           // Optional. Logs events to console when true.
+  respectDnt: true,       // Optional. Honor browser Do Not Track. Default: true.
+  respectGpc: true,       // Optional. Honor Global Privacy Control. Default: true.
+})
+```
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `projectId` | `string` | **required** | Your SDK project ID from the dashboard |
+| `endpoint` | `string` | `'https://indiebob.com/api/collect'` | Override for self-hosted instances |
+| `debug` | `boolean` | `false` | Log all events to browser console |
+| `respectDnt` | `boolean` | `true` | Honor the browser's Do Not Track header |
+| `respectGpc` | `boolean` | `true` | Honor Global Privacy Control signal (legally binding in CA/GDPR) |
+
+## API Reference
+
+### `IndieBob.init(config)`
+
+Creates and returns a tracker instance. Call once at app startup.
+
+```ts
+const bob = IndieBob.init({ projectId: 'proj_abc123def456ghij' })
+```
+
+---
+
+### `bob.page(overrides?)`
+
+Track a page view. Call this on every page load and SPA navigation.
+
+```ts
+bob.page()                           // Auto-detects path, title, referrer
+bob.page({ path: '/pricing' })       // Override path
+bob.page({ title: 'Pricing Page' }) // Override title
+```
+
+**Auto-detected:** URL path, page title, referrer, UTM parameters, device type.
+
+---
+
+### `bob.track(event, properties?)`
+
+Track a custom event.
+
+```ts
+bob.track('signup_started')
+bob.track('trial_activated', { plan: 'pro' })
+bob.track('feature_used', { feature: 'csv_export', count: 3 })
+bob.track('checkout_completed', { revenue: 29.00, currency: 'USD', plan: 'pro-monthly' })
+```
+
+**`event`** — string, required. Max 256 characters. Use `snake_case` by convention.
+
+**`properties`** — plain object, optional. Values must be JSON-serializable.
+
+---
+
+### `bob.identify(userId, traits?)`
+
+Associate the current anonymous visitor with a known user ID. Call this after login or signup.
+
+```ts
+bob.identify('user_123', {
+  email: 'jane@example.com',
+  name: 'Jane Smith',
+  plan: 'pro',
+  createdAt: '2026-01-15',
+})
+```
+
+**`userId`** — string, required. Your internal user ID. Never pass PII as the userId directly.
+
+**`traits`** — plain object, optional. Can include `email` for attribution linking.
+
+After `identify()`, all subsequent events are linked to this userId until the session ends.
+
+---
+
+### `bob.revenue(data)`
+
+Track a revenue event. Use alongside Stripe webhooks for complete attribution.
+
+```ts
+bob.revenue({
+  amount: 29.00,           // Required. Positive number.
+  currency: 'USD',         // Optional. Default: 'USD'. ISO 4217 code.
+  plan: 'pro-monthly',     // Optional. Your plan name.
+  type: 'new',             // Optional. 'new' | 'renewal' | 'upgrade' | 'downgrade'
+})
+```
+
+---
+
+### Privacy Controls
+
+```ts
+bob.optOut()       // Stop all tracking. Clears all stored identifiers.
+bob.optIn()        // Re-enable tracking.
+bob.isOptedOut()   // Returns boolean.
+```
+
+---
+
+### Debug / Testing
+
+```ts
+bob.getAnonymousId()  // Returns the current anonymous ID
+bob.getSessionId()    // Returns the current session ID
+bob.getConfig()       // Returns a read-only copy of the config
+bob.flush()           // Force-send all queued events immediately
+```
+
+---
+
+## Framework Integrations
+
+### Vue / Nuxt
+
+```ts
+// main.ts or plugins/tracker.client.ts
+import { IndieBobPlugin } from '@indiebob/tracker/vue'
+
+app.use(IndieBobPlugin, { projectId: 'proj_abc123def456ghij' })
+```
+
+Then in any component:
+
+```ts
+import { useTracker } from '@indiebob/tracker/vue'
+
+const bob = useTracker()
+bob.track('button_clicked', { button: 'cta_hero' })
+```
+
+**Nuxt plugin** (`plugins/tracker.client.ts`):
+
+```ts
+import { IndieBobPlugin } from '@indiebob/tracker/vue'
+
+export default defineNuxtPlugin((nuxtApp) => {
+  nuxtApp.vueApp.use(IndieBobPlugin, {
+    projectId: useRuntimeConfig().public.trackerProjectId,
+  })
+})
+```
+
+Page views auto-track on vue-router navigation.
+
+### React
+
+```tsx
+import { IndieBob } from '@indiebob/tracker'
+import { useEffect } from 'react'
+
+// Initialize once at app root
+const bob = IndieBob.init({ projectId: 'proj_abc123def456ghij' })
+
+// In a page component or layout
+useEffect(() => {
+  bob.page()
+}, [pathname])
+```
+
+### Vanilla JS (Script Tag)
+
+```html
+<script src="https://assets.indiebob.com/tracker/latest/indiebob.min.js"></script>
+<script>
+  const bob = IndieBob.init({ projectId: 'proj_abc123def456ghij' })
+  bob.page()
+</script>
+```
+
+### Server-Side (Node.js)
+
+```ts
+import { IndieBob } from '@indiebob/tracker/server'
+
+const bob = IndieBob.initServer({ projectId: 'proj_abc123def456ghij' })
+bob.track('server_event', { source: 'cron_job' })
+```
+
+---
+
+## How It Works
+
+### Anonymous ID
+
+A random 21-character ID is generated on first visit and stored in `localStorage`. This persists across sessions so you can track a visitor's journey before they sign up.
+
+- Stored as `_ib_anon` in localStorage
+- Falls back to sessionStorage if localStorage is blocked
+- Never uses cookies — no consent banner required
+- Cleared when `optOut()` is called
+
+### Session ID
+
+A session ID is generated per browser tab/window using `crypto.randomUUID()`. Sessions expire after 30 minutes of inactivity or when the tab closes.
+
+### UTM Attribution
+
+UTM parameters (`utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`) are captured from the URL automatically on `init()`.
+
+- **First-touch** attribution stored in `_ib_first_utm` — never overwritten
+- **Last-touch** attribution in `_ib_last_utm` — updated each time UTMs are present in the URL
+- Enables "which campaign drove this paying customer?" — the core attribution question
+
+### Event Batching
+
+Events are batched for efficiency:
+- Sent when 10 events accumulate
+- Sent every 5 seconds regardless
+- Sent immediately when the page becomes hidden (tab switch, close)
+- Queued in localStorage when offline; flushed when back online
+
+### Privacy by Default
+
+The SDK respects:
+- **Do Not Track** (`navigator.doNotTrack === '1'`): no events sent, `respectDnt: true` by default
+- **Global Privacy Control** (`navigator.globalPrivacyControl`): legally binding under CCPA in California, `respectGpc: true` by default
+- Neither cookies nor fingerprinting is used at any point
+- IP addresses are never stored by the server — only the country code derived at ingestion time
+
+---
+
+## What Is and Isn't Collected
+
+### Automatically collected (on `page()`)
+
+| Data | What | Stored As |
+|---|---|---|
+| Page path | `/pricing`, `/blog/post-1` | String |
+| Page title | `document.title` | String |
+| Referrer | `document.referrer` | String |
+| UTM params | From URL query string | Object |
+| Screen size | `window.innerWidth/Height` | Numbers |
+| Device type | Derived from screen size | `'desktop'` \| `'mobile'` \| `'tablet'` |
+| Browser locale | `navigator.language` | String |
+| Timezone | `Intl.DateTimeFormat().resolvedOptions().timeZone` | String |
+| Country | Derived server-side from IP | String (e.g. `'US'`) |
+
+### NOT collected
+
+- IP addresses (never stored, used only for country lookup then discarded)
+- Browser fingerprint
+- Cookies
+- Personal data (name, email, etc.) unless you pass it to `identify()`
+- Cross-site tracking data
+
+---
+
+## Privacy & Compliance
+
+### GDPR (EU)
+
+The SDK does not use cookies and does not collect personal data by default. The `anonymousId` is a random identifier with no link to personal identity. Under GDPR, anonymous analytics may not require a consent banner — but consult your legal team.
+
+When a user calls `optOut()`, all stored keys are cleared: `_ib_anon`, `_ib_session`, `_ib_first_utm`, `_ib_last_utm`, `_ib_referrer`, `_ib_queue`.
+
+### CCPA (California)
+
+Global Privacy Control (GPC) is automatically honored. If a user has GPC enabled in their browser, the SDK sends no events. This is the legally correct behavior under CCPA as amended by CPRA.
+
+### Cookie Law (EU ePrivacy Directive)
+
+No cookies are set. The localStorage identifiers are not cookies and fall outside the scope of the Cookie Law.
+
+---
+
+## Self-Hosting
+
+Point the SDK at your own IndieBob instance:
+
+```ts
+const bob = IndieBob.init({
+  projectId: 'proj_abc123def456ghij',
+  endpoint: 'https://your-indiebob.example.com/api/collect',
+})
+```
+
+---
+
+## Versioning & Backwards Compatibility
+
+This SDK follows [Semantic Versioning](https://semver.org/).
+
+**1.x guarantee**: All public methods listed in this README are stable. We will never:
+- Remove a method in a 1.x release
+- Change the behavior of an existing method without a deprecation period
+- Break the wire format for events that include `v: 1`
+
+**Upgrade path**: `npm update @indiebob/tracker` — no code changes required within 1.x.
+
+**Deprecation process**: Methods marked `@deprecated` in JSDoc will log a warning in `debug: true` mode. They remain functional until the next major version.
+
+---
+
+## Bundle Size
+
+| Bundle | Size (gzip) |
+|---|---|
+| Browser IIFE (`tracker.js`) | < 5KB |
+| ESM tree-shakeable | < 4KB |
+| Server (Node.js) | No limit |
+
+Zero runtime dependencies.
+
+---
+
+## License
+
+MIT

package/dist/chunk-XKQYO25W.js

@@ -0,0 +1,2 @@
+var J=Object.defineProperty,z=Object.defineProperties;var G=Object.getOwnPropertyDescriptors;var k=Object.getOwnPropertySymbols;var W=Object.prototype.hasOwnProperty,Z=Object.prototype.propertyIsEnumerable;var A=(e,t,o)=>t in e?J(e,t,{enumerable:true,configurable:true,writable:true,value:o}):e[t]=o,d=(e,t)=>{for(var o in t||(t={}))W.call(t,o)&&A(e,o,t[o]);if(k)for(var o of k(t))Z.call(t,o)&&A(e,o,t[o]);return e},x=(e,t)=>z(e,G(t));var a=(e,t,o)=>new Promise((n,i)=>{var r=s=>{try{l(o.next(s));}catch(c){i(c);}},g=s=>{try{l(o.throw(s));}catch(c){i(c);}},l=s=>s.done?n(s.value):Promise.resolve(s.value).then(r,g);l((o=o.apply(e,t)).next());});var $="https://indiebob.com/api/collect";function D(e){var t,o,n,i;if(!e.projectId||!e.projectId.startsWith("proj_"))throw new Error(`[IndieBob] Invalid projectId "${e.projectId}". Must start with "proj_".`);return {projectId:e.projectId,endpoint:(t=e.endpoint)!=null?t:$,debug:(o=e.debug)!=null?o:false,respectDnt:(n=e.respectDnt)!=null?n:true,respectGpc:(i=e.respectGpc)!=null?i:true}}var u="_ib_anon";function h(){let e="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_-",t="";if(typeof crypto!="undefined"&&crypto.getRandomValues){let o=new Uint8Array(21);crypto.getRandomValues(o);for(let n of o)t+=e[n%e.length];}else for(let o=0;o<21;o++)t+=e[Math.floor(Math.random()*e.length)];return t}function v(){try{let e=localStorage.getItem(u);return e||(e=h(),localStorage.setItem(u,e)),e}catch(e){try{let t=sessionStorage.getItem(u);return t||(t=h(),sessionStorage.setItem(u,t)),t}catch(t){return h()}}}function P(){try{localStorage.removeItem(u);}catch(e){}try{sessionStorage.removeItem(u);}catch(e){}}var y="_ib_session",I="_ib_session_last";function N(){try{return crypto.randomUUID()}catch(e){return Math.random().toString(36).slice(2)+Math.random().toString(36).slice(2)}}function S(){var e;try{let t=Date.now(),o=parseInt((e=sessionStorage.getItem(I))!=null?e:"0",10),n=sessionStorage.getItem(y),i=o>0&&t-o>18e5;return (!n||i)&&(n=N(),sessionStorage.setItem(y,n)),sessionStorage.setItem(I,String(t)),n}catch(t){return N()}}function U(){try{sessionStorage.removeItem(y);}catch(e){}try{sessionStorage.removeItem(I);}catch(e){}}var b="_ib_first_utm",M="_ib_last_utm",_="_ib_referrer";function q(e){let t=new URLSearchParams(e),o={},n=false;return t.has("utm_source")&&(o.source=t.get("utm_source"),n=true),t.has("utm_medium")&&(o.medium=t.get("utm_medium"),n=true),t.has("utm_campaign")&&(o.campaign=t.get("utm_campaign"),n=true),t.has("utm_term")&&(o.term=t.get("utm_term"),n=true),t.has("utm_content")&&(o.content=t.get("utm_content"),n=true),n?o:null}function B(e,t){let o=q(e);try{o&&!localStorage.getItem(b)&&localStorage.setItem(b,JSON.stringify(o)),o&&localStorage.setItem(M,JSON.stringify(o)),t&&!localStorage.getItem(_)&&localStorage.setItem(_,t);}catch(n){}}function F(e){var t;return (t=q(e))!=null?t:void 0}function L(){try{localStorage.removeItem(b);}catch(e){}try{localStorage.removeItem(M);}catch(e){}try{localStorage.removeItem(_);}catch(e){}}var p="_ib_optout",tt="_ib_queue";function f(e){try{if(localStorage.getItem(p))return !1}catch(t){}return !(e.respectDnt&&typeof navigator!="undefined"&&(navigator.doNotTrack==="1"||navigator.msDoNotTrack==="1")||e.respectGpc&&typeof navigator!="undefined"&&navigator.globalPrivacyControl===true)}function j(){try{localStorage.setItem(p,"1");}catch(e){}P(),U(),L();try{localStorage.removeItem(tt);}catch(e){}}function Y(){try{localStorage.removeItem(p);}catch(e){}}function K(){try{return !!localStorage.getItem(p)}catch(e){return  false}}var et=[1e3,2e3,4e3];function ot(e){return a(this,null,function*(){return new Promise(t=>setTimeout(t,e))})}function w(e,t,o=false){return a(this,null,function*(){let n=JSON.stringify(e);if(o&&typeof navigator!="undefined"&&navigator.sendBeacon){let i=new Blob([n],{type:"application/json"}),r=navigator.sendBeacon(t.endpoint,i);return t.debug&&console.log("[IndieBob] sendBeacon:",r,e.batch.length,"events"),r}for(let i=0;i<3;i++){try{let r=yield fetch(t.endpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:n,keepalive:!0});if(r.ok)return t.debug&&console.log("[IndieBob] sent:",e.batch.length,"events"),!0;if(r.status>=400&&r.status<500)return t.debug&&console.warn("[IndieBob] 4xx error, not retrying:",r.status),!1}catch(r){t.debug&&console.warn("[IndieBob] fetch error (attempt",i+1,"):",r);}i<2&&(yield ot(et[i]));}return t.debug&&console.warn("[IndieBob] failed to send after",3,"attempts"),false})}var E="_ib_queue",nt=10,it=5e3,rt=50,m=class{constructor(t){this.queue=[];this.timer=null;this.flushing=false;this.config=t,this.startTimer(),this.setupVisibilityFlush(),this.setupOnlineFlush();}push(t){this.queue.push(t),this.queue.length>=nt&&this.flush();}flush(t=false){return a(this,null,function*(){if(this.flushing&&!t||this.queue.length===0)return;this.flushing=true;let o=this.queue.splice(0);(yield w({batch:o},this.config,t))||this.pushToOfflineQueue(o),this.flushing=false;})}flushOfflineQueue(){return a(this,null,function*(){let t=this.getOfflineQueue();if(t.length===0)return;this.clearOfflineQueue(),yield w({batch:t},this.config);})}destroy(){this.timer&&clearInterval(this.timer);}startTimer(){this.timer=setInterval(()=>{this.queue.length>0&&this.flush();},it);}setupVisibilityFlush(){typeof document!="undefined"&&document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flush(true);},{passive:true});}setupOnlineFlush(){typeof window!="undefined"&&(window.addEventListener("online",()=>{this.flushOfflineQueue();}),navigator.onLine&&this.flushOfflineQueue());}pushToOfflineQueue(t){try{let i=[...this.getOfflineQueue(),...t].slice(-rt);localStorage.setItem(E,JSON.stringify(i));}catch(o){}}getOfflineQueue(){try{let t=localStorage.getItem(E);return t?JSON.parse(t):[]}catch(t){return []}}clearOfflineQueue(){try{localStorage.removeItem(E);}catch(t){}}};function Q(){if(typeof window=="undefined")return "desktop";let e=window.innerWidth;return e<=768?"mobile":e<=1024?"tablet":"desktop"}function V(){return typeof window=="undefined"?{width:0,height:0}:{width:window.innerWidth,height:window.innerHeight}}function T(e){var c,O,R,C;let t=typeof window=="undefined",o=(c=e==null?void 0:e.path)!=null?c:t?"":window.location.pathname+window.location.search,n=t?"":window.location.href,i=(O=e==null?void 0:e.title)!=null?O:t?"":document.title,r=(R=e==null?void 0:e.referrer)!=null?R:t?"":document.referrer,g=V(),l=Q(),s=t?void 0:F(window.location.search);return {page:{path:o,url:n,title:i,referrer:r},device:x(d({},g),{type:l}),utm:s,locale:t?"en":navigator.language,timezone:t?"UTC":(C=Intl.DateTimeFormat().resolvedOptions().timeZone)!=null?C:"UTC",sdkVersion:"0.1.0"}}function H(e){if(typeof window=="undefined")return ()=>{};let t=history.pushState.bind(history),o=history.replaceState.bind(history);return history.pushState=function(...n){t(...n),e();},history.replaceState=function(...n){o(...n);},window.addEventListener("popstate",e),()=>{history.pushState=t,history.replaceState=o,window.removeEventListener("popstate",e);}}var X=class e{constructor(t){this.cleanupHistory=null;this.config=t,this.queue=new m(t),typeof window!="undefined"&&B(window.location.search,document.referrer);}static init(t){let o=D(t);return new e(o)}page(t){f(this.config)&&this.queue.push(this.buildEvent("page",{context:T(t)}));}track(t,o){f(this.config)&&this.queue.push(this.buildEvent("track",{event:t,properties:o}));}identify(t,o){f(this.config)&&(this.userId=t,this.queue.push(this.buildEvent("identify",{traits:o,userId:t})));}revenue(t){var o;f(this.config)&&this.queue.push(this.buildEvent("revenue",{revenue:{amount:t.amount,currency:(o=t.currency)!=null?o:"USD",plan:t.plan,type:t.type}}));}optOut(){this.queue.flush(),j(),this.userId=void 0,this.config.debug&&console.log("[IndieBob] opted out");}optIn(){Y(),this.config.debug&&console.log("[IndieBob] opted in");}isOptedOut(){return K()}flush(){return a(this,null,function*(){yield this.queue.flush();})}getAnonymousId(){return v()}getSessionId(){return S()}getConfig(){return Object.freeze(d({},this.config))}enableAutoPage(){var t;return (t=this.cleanupHistory)==null||t.call(this),this.cleanupHistory=H(()=>this.page()),()=>{var o;(o=this.cleanupHistory)==null||o.call(this),this.cleanupHistory=null;}}buildEvent(t,o){var n,i;return {v:1,projectId:this.config.projectId,type:t,anonymousId:v(),userId:(n=this.userId)!=null?n:o.userId,sessionId:S(),timestamp:new Date().toISOString(),context:(i=o.context)!=null?i:T(),event:o.event,properties:o.properties,traits:o.traits,revenue:o.revenue}}};
+export{X as a};

package/dist/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var J=Object.defineProperty,z=Object.defineProperties;var G=Object.getOwnPropertyDescriptors;var k=Object.getOwnPropertySymbols;var W=Object.prototype.hasOwnProperty,Z=Object.prototype.propertyIsEnumerable;var A=(e,t,o)=>t in e?J(e,t,{enumerable:true,configurable:true,writable:true,value:o}):e[t]=o,d=(e,t)=>{for(var o in t||(t={}))W.call(t,o)&&A(e,o,t[o]);if(k)for(var o of k(t))Z.call(t,o)&&A(e,o,t[o]);return e},x=(e,t)=>z(e,G(t));var a=(e,t,o)=>new Promise((n,i)=>{var r=s=>{try{l(o.next(s));}catch(c){i(c);}},g=s=>{try{l(o.throw(s));}catch(c){i(c);}},l=s=>s.done?n(s.value):Promise.resolve(s.value).then(r,g);l((o=o.apply(e,t)).next());});var $="https://indiebob.com/api/collect";function D(e){var t,o,n,i;if(!e.projectId||!e.projectId.startsWith("proj_"))throw new Error(`[IndieBob] Invalid projectId "${e.projectId}". Must start with "proj_".`);return {projectId:e.projectId,endpoint:(t=e.endpoint)!=null?t:$,debug:(o=e.debug)!=null?o:false,respectDnt:(n=e.respectDnt)!=null?n:true,respectGpc:(i=e.respectGpc)!=null?i:true}}var u="_ib_anon";function h(){let e="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_-",t="";if(typeof crypto!="undefined"&&crypto.getRandomValues){let o=new Uint8Array(21);crypto.getRandomValues(o);for(let n of o)t+=e[n%e.length];}else for(let o=0;o<21;o++)t+=e[Math.floor(Math.random()*e.length)];return t}function v(){try{let e=localStorage.getItem(u);return e||(e=h(),localStorage.setItem(u,e)),e}catch(e){try{let t=sessionStorage.getItem(u);return t||(t=h(),sessionStorage.setItem(u,t)),t}catch(t){return h()}}}function P(){try{localStorage.removeItem(u);}catch(e){}try{sessionStorage.removeItem(u);}catch(e){}}var y="_ib_session",I="_ib_session_last";function N(){try{return crypto.randomUUID()}catch(e){return Math.random().toString(36).slice(2)+Math.random().toString(36).slice(2)}}function S(){var e;try{let t=Date.now(),o=parseInt((e=sessionStorage.getItem(I))!=null?e:"0",10),n=sessionStorage.getItem(y),i=o>0&&t-o>18e5;return (!n||i)&&(n=N(),sessionStorage.setItem(y,n)),sessionStorage.setItem(I,String(t)),n}catch(t){return N()}}function U(){try{sessionStorage.removeItem(y);}catch(e){}try{sessionStorage.removeItem(I);}catch(e){}}var b="_ib_first_utm",M="_ib_last_utm",_="_ib_referrer";function q(e){let t=new URLSearchParams(e),o={},n=false;return t.has("utm_source")&&(o.source=t.get("utm_source"),n=true),t.has("utm_medium")&&(o.medium=t.get("utm_medium"),n=true),t.has("utm_campaign")&&(o.campaign=t.get("utm_campaign"),n=true),t.has("utm_term")&&(o.term=t.get("utm_term"),n=true),t.has("utm_content")&&(o.content=t.get("utm_content"),n=true),n?o:null}function B(e,t){let o=q(e);try{o&&!localStorage.getItem(b)&&localStorage.setItem(b,JSON.stringify(o)),o&&localStorage.setItem(M,JSON.stringify(o)),t&&!localStorage.getItem(_)&&localStorage.setItem(_,t);}catch(n){}}function F(e){var t;return (t=q(e))!=null?t:void 0}function L(){try{localStorage.removeItem(b);}catch(e){}try{localStorage.removeItem(M);}catch(e){}try{localStorage.removeItem(_);}catch(e){}}var p="_ib_optout",tt="_ib_queue";function f(e){try{if(localStorage.getItem(p))return !1}catch(t){}return !(e.respectDnt&&typeof navigator!="undefined"&&(navigator.doNotTrack==="1"||navigator.msDoNotTrack==="1")||e.respectGpc&&typeof navigator!="undefined"&&navigator.globalPrivacyControl===true)}function j(){try{localStorage.setItem(p,"1");}catch(e){}P(),U(),L();try{localStorage.removeItem(tt);}catch(e){}}function Y(){try{localStorage.removeItem(p);}catch(e){}}function K(){try{return !!localStorage.getItem(p)}catch(e){return  false}}var et=[1e3,2e3,4e3];function ot(e){return a(this,null,function*(){return new Promise(t=>setTimeout(t,e))})}function w(e,t,o=false){return a(this,null,function*(){let n=JSON.stringify(e);if(o&&typeof navigator!="undefined"&&navigator.sendBeacon){let i=new Blob([n],{type:"application/json"}),r=navigator.sendBeacon(t.endpoint,i);return t.debug&&console.log("[IndieBob] sendBeacon:",r,e.batch.length,"events"),r}for(let i=0;i<3;i++){try{let r=yield fetch(t.endpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:n,keepalive:!0});if(r.ok)return t.debug&&console.log("[IndieBob] sent:",e.batch.length,"events"),!0;if(r.status>=400&&r.status<500)return t.debug&&console.warn("[IndieBob] 4xx error, not retrying:",r.status),!1}catch(r){t.debug&&console.warn("[IndieBob] fetch error (attempt",i+1,"):",r);}i<2&&(yield ot(et[i]));}return t.debug&&console.warn("[IndieBob] failed to send after",3,"attempts"),false})}var E="_ib_queue",nt=10,it=5e3,rt=50,m=class{constructor(t){this.queue=[];this.timer=null;this.flushing=false;this.config=t,this.startTimer(),this.setupVisibilityFlush(),this.setupOnlineFlush();}push(t){this.queue.push(t),this.queue.length>=nt&&this.flush();}flush(t=false){return a(this,null,function*(){if(this.flushing&&!t||this.queue.length===0)return;this.flushing=true;let o=this.queue.splice(0);(yield w({batch:o},this.config,t))||this.pushToOfflineQueue(o),this.flushing=false;})}flushOfflineQueue(){return a(this,null,function*(){let t=this.getOfflineQueue();if(t.length===0)return;this.clearOfflineQueue(),yield w({batch:t},this.config);})}destroy(){this.timer&&clearInterval(this.timer);}startTimer(){this.timer=setInterval(()=>{this.queue.length>0&&this.flush();},it);}setupVisibilityFlush(){typeof document!="undefined"&&document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flush(true);},{passive:true});}setupOnlineFlush(){typeof window!="undefined"&&(window.addEventListener("online",()=>{this.flushOfflineQueue();}),navigator.onLine&&this.flushOfflineQueue());}pushToOfflineQueue(t){try{let i=[...this.getOfflineQueue(),...t].slice(-rt);localStorage.setItem(E,JSON.stringify(i));}catch(o){}}getOfflineQueue(){try{let t=localStorage.getItem(E);return t?JSON.parse(t):[]}catch(t){return []}}clearOfflineQueue(){try{localStorage.removeItem(E);}catch(t){}}};function Q(){if(typeof window=="undefined")return "desktop";let e=window.innerWidth;return e<=768?"mobile":e<=1024?"tablet":"desktop"}function V(){return typeof window=="undefined"?{width:0,height:0}:{width:window.innerWidth,height:window.innerHeight}}function T(e){var c,O,R,C;let t=typeof window=="undefined",o=(c=e==null?void 0:e.path)!=null?c:t?"":window.location.pathname+window.location.search,n=t?"":window.location.href,i=(O=e==null?void 0:e.title)!=null?O:t?"":document.title,r=(R=e==null?void 0:e.referrer)!=null?R:t?"":document.referrer,g=V(),l=Q(),s=t?void 0:F(window.location.search);return {page:{path:o,url:n,title:i,referrer:r},device:x(d({},g),{type:l}),utm:s,locale:t?"en":navigator.language,timezone:t?"UTC":(C=Intl.DateTimeFormat().resolvedOptions().timeZone)!=null?C:"UTC",sdkVersion:"0.1.0"}}function H(e){if(typeof window=="undefined")return ()=>{};let t=history.pushState.bind(history),o=history.replaceState.bind(history);return history.pushState=function(...n){t(...n),e();},history.replaceState=function(...n){o(...n);},window.addEventListener("popstate",e),()=>{history.pushState=t,history.replaceState=o,window.removeEventListener("popstate",e);}}var X=class e{constructor(t){this.cleanupHistory=null;this.config=t,this.queue=new m(t),typeof window!="undefined"&&B(window.location.search,document.referrer);}static init(t){let o=D(t);return new e(o)}page(t){f(this.config)&&this.queue.push(this.buildEvent("page",{context:T(t)}));}track(t,o){f(this.config)&&this.queue.push(this.buildEvent("track",{event:t,properties:o}));}identify(t,o){f(this.config)&&(this.userId=t,this.queue.push(this.buildEvent("identify",{traits:o,userId:t})));}revenue(t){var o;f(this.config)&&this.queue.push(this.buildEvent("revenue",{revenue:{amount:t.amount,currency:(o=t.currency)!=null?o:"USD",plan:t.plan,type:t.type}}));}optOut(){this.queue.flush(),j(),this.userId=void 0,this.config.debug&&console.log("[IndieBob] opted out");}optIn(){Y(),this.config.debug&&console.log("[IndieBob] opted in");}isOptedOut(){return K()}flush(){return a(this,null,function*(){yield this.queue.flush();})}getAnonymousId(){return v()}getSessionId(){return S()}getConfig(){return Object.freeze(d({},this.config))}enableAutoPage(){var t;return (t=this.cleanupHistory)==null||t.call(this),this.cleanupHistory=H(()=>this.page()),()=>{var o;(o=this.cleanupHistory)==null||o.call(this),this.cleanupHistory=null;}}buildEvent(t,o){var n,i;return {v:1,projectId:this.config.projectId,type:t,anonymousId:v(),userId:(n=this.userId)!=null?n:o.userId,sessionId:S(),timestamp:new Date().toISOString(),context:(i=o.context)!=null?i:T(),event:o.event,properties:o.properties,traits:o.traits,revenue:o.revenue}}};
+exports.IndieBob=X;

package/dist/index.d.mts

@@ -0,0 +1,171 @@
+/**
+ * Configuration for the IndieBob tracker.
+ */
+interface TrackerConfig {
+    /** Your SDK project ID from the IndieBob dashboard. Format: 'proj_...' */
+    projectId: string;
+    /** Ingestion endpoint URL. Default: 'https://indiebob.com/api/collect' */
+    endpoint?: string;
+    /** Log all events to the browser console. Default: false */
+    debug?: boolean;
+    /** Honor the browser Do Not Track header. Default: true */
+    respectDnt?: boolean;
+    /** Honor Global Privacy Control signal (legally binding in CA/GDPR). Default: true */
+    respectGpc?: boolean;
+}
+/** Resolved config with all defaults applied. */
+interface ResolvedConfig {
+    projectId: string;
+    endpoint: string;
+    debug: boolean;
+    respectDnt: boolean;
+    respectGpc: boolean;
+}
+/** The tracking event type. */
+type EventType = 'page' | 'track' | 'identify' | 'revenue';
+/** Device category. */
+type DeviceType = 'desktop' | 'mobile' | 'tablet';
+/** Revenue event type. */
+type RevenueType = 'new' | 'renewal' | 'upgrade' | 'downgrade';
+/** UTM attribution data. */
+interface UtmData {
+    source?: string;
+    medium?: string;
+    campaign?: string;
+    term?: string;
+    content?: string;
+}
+/** Context attached to every event. */
+interface EventContext {
+    page: {
+        path: string;
+        url: string;
+        title: string;
+        referrer: string;
+    };
+    device: {
+        width: number;
+        height: number;
+        type: DeviceType;
+    };
+    utm?: UtmData;
+    locale: string;
+    timezone: string;
+    sdkVersion: string;
+}
+/** A single tracking event in wire format (v1 schema). */
+interface TrackerEvent {
+    /** Schema version. Always 1 for this SDK. Enables server-side backwards compat. */
+    v: 1;
+    projectId: string;
+    type: EventType;
+    anonymousId: string;
+    userId?: string;
+    sessionId: string;
+    timestamp: string;
+    context: EventContext;
+    event?: string;
+    properties?: Record<string, unknown>;
+    traits?: Record<string, unknown>;
+    revenue?: {
+        amount: number;
+        currency: string;
+        plan?: string;
+        type?: RevenueType;
+    };
+}
+/** Overrides for manual page() calls. */
+interface PageOverrides {
+    path?: string;
+    title?: string;
+    referrer?: string;
+}
+/** Revenue data for bob.revenue(). */
+interface RevenueData {
+    amount: number;
+    currency?: string;
+    plan?: string;
+    type?: RevenueType;
+}
+
+/**
+ * IndieBob Analytics Tracker.
+ *
+ * @example
+ * const bob = IndieBob.init({ projectId: 'proj_abc123def456ghij' })
+ * bob.page()
+ */
+declare class IndieBob {
+    private config;
+    private queue;
+    private userId;
+    private cleanupHistory;
+    private constructor();
+    /**
+     * Create a tracker instance. Call once at app startup.
+     *
+     * @example
+     * const bob = IndieBob.init({ projectId: 'proj_your16charId' })
+     */
+    static init(config: TrackerConfig): IndieBob;
+    /**
+     * Track a page view. Call on every page load and SPA navigation.
+     *
+     * @example
+     * bob.page()
+     * bob.page({ path: '/pricing' })
+     */
+    page(overrides?: PageOverrides): void;
+    /**
+     * Track a custom event.
+     *
+     * @example
+     * bob.track('signup_started')
+     * bob.track('feature_used', { feature: 'csv_export' })
+     */
+    track(event: string, properties?: Record<string, unknown>): void;
+    /**
+     * Associate the current anonymous visitor with a known user ID.
+     * Call after login or signup.
+     *
+     * @example
+     * bob.identify('user_123', { email: 'jane@example.com', plan: 'pro' })
+     */
+    identify(userId: string, traits?: Record<string, unknown>): void;
+    /**
+     * Track a revenue event.
+     *
+     * @example
+     * bob.revenue({ amount: 29.00, currency: 'USD', plan: 'pro-monthly', type: 'new' })
+     */
+    revenue(data: RevenueData): void;
+    /**
+     * Stop all tracking and clear all stored identifiers.
+     * Respects user's privacy preferences.
+     */
+    optOut(): void;
+    /** Re-enable tracking after optOut(). */
+    optIn(): void;
+    /** Returns true if the user has explicitly opted out. */
+    isOptedOut(): boolean;
+    /** Force-send all queued events immediately. Useful in tests. */
+    flush(): Promise<void>;
+    /** Get the current anonymous ID. */
+    getAnonymousId(): string;
+    /** Get the current session ID. */
+    getSessionId(): string;
+    /** Get the resolved configuration (read-only). */
+    getConfig(): Readonly<ResolvedConfig>;
+    /**
+     * Enable auto-tracking of SPA navigation.
+     * Returns a cleanup function to remove the listeners.
+     *
+     * @example
+     * const cleanup = bob.enableAutoPage()
+     * // Later: cleanup()
+     */
+    enableAutoPage(): () => void;
+    private buildEvent;
+}
+
+export { type DeviceType, type EventContext, type EventType, IndieBob, type PageOverrides, type RevenueData, type RevenueType, type TrackerConfig, type TrackerEvent, type UtmData };

package/dist/index.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Configuration for the IndieBob tracker.
+ */
+interface TrackerConfig {
+    /** Your SDK project ID from the IndieBob dashboard. Format: 'proj_...' */
+    projectId: string;
+    /** Ingestion endpoint URL. Default: 'https://indiebob.com/api/collect' */
+    endpoint?: string;
+    /** Log all events to the browser console. Default: false */
+    debug?: boolean;
+    /** Honor the browser Do Not Track header. Default: true */
+    respectDnt?: boolean;
+    /** Honor Global Privacy Control signal (legally binding in CA/GDPR). Default: true */
+    respectGpc?: boolean;
+}
+/** Resolved config with all defaults applied. */
+interface ResolvedConfig {
+    projectId: string;
+    endpoint: string;
+    debug: boolean;
+    respectDnt: boolean;
+    respectGpc: boolean;
+}
+/** The tracking event type. */
+type EventType = 'page' | 'track' | 'identify' | 'revenue';
+/** Device category. */
+type DeviceType = 'desktop' | 'mobile' | 'tablet';
+/** Revenue event type. */
+type RevenueType = 'new' | 'renewal' | 'upgrade' | 'downgrade';
+/** UTM attribution data. */
+interface UtmData {
+    source?: string;
+    medium?: string;
+    campaign?: string;
+    term?: string;
+    content?: string;
+}
+/** Context attached to every event. */
+interface EventContext {
+    page: {
+        path: string;
+        url: string;
+        title: string;
+        referrer: string;
+    };
+    device: {
+        width: number;
+        height: number;
+        type: DeviceType;
+    };
+    utm?: UtmData;
+    locale: string;
+    timezone: string;
+    sdkVersion: string;
+}
+/** A single tracking event in wire format (v1 schema). */
+interface TrackerEvent {
+    /** Schema version. Always 1 for this SDK. Enables server-side backwards compat. */
+    v: 1;
+    projectId: string;
+    type: EventType;
+    anonymousId: string;
+    userId?: string;
+    sessionId: string;
+    timestamp: string;
+    context: EventContext;
+    event?: string;
+    properties?: Record<string, unknown>;
+    traits?: Record<string, unknown>;
+    revenue?: {
+        amount: number;
+        currency: string;
+        plan?: string;
+        type?: RevenueType;
+    };
+}
+/** Overrides for manual page() calls. */
+interface PageOverrides {
+    path?: string;
+    title?: string;
+    referrer?: string;
+}
+/** Revenue data for bob.revenue(). */
+interface RevenueData {
+    amount: number;
+    currency?: string;
+    plan?: string;
+    type?: RevenueType;
+}
+
+/**
+ * IndieBob Analytics Tracker.
+ *
+ * @example
+ * const bob = IndieBob.init({ projectId: 'proj_abc123def456ghij' })
+ * bob.page()
+ */
+declare class IndieBob {
+    private config;
+    private queue;
+    private userId;
+    private cleanupHistory;
+    private constructor();
+    /**
+     * Create a tracker instance. Call once at app startup.
+     *
+     * @example
+     * const bob = IndieBob.init({ projectId: 'proj_your16charId' })
+     */
+    static init(config: TrackerConfig): IndieBob;
+    /**
+     * Track a page view. Call on every page load and SPA navigation.
+     *
+     * @example
+     * bob.page()
+     * bob.page({ path: '/pricing' })
+     */
+    page(overrides?: PageOverrides): void;
+    /**
+     * Track a custom event.
+     *
+     * @example
+     * bob.track('signup_started')
+     * bob.track('feature_used', { feature: 'csv_export' })
+     */
+    track(event: string, properties?: Record<string, unknown>): void;
+    /**
+     * Associate the current anonymous visitor with a known user ID.
+     * Call after login or signup.
+     *
+     * @example
+     * bob.identify('user_123', { email: 'jane@example.com', plan: 'pro' })
+     */
+    identify(userId: string, traits?: Record<string, unknown>): void;
+    /**
+     * Track a revenue event.
+     *
+     * @example
+     * bob.revenue({ amount: 29.00, currency: 'USD', plan: 'pro-monthly', type: 'new' })
+     */
+    revenue(data: RevenueData): void;
+    /**
+     * Stop all tracking and clear all stored identifiers.
+     * Respects user's privacy preferences.
+     */
+    optOut(): void;
+    /** Re-enable tracking after optOut(). */
+    optIn(): void;
+    /** Returns true if the user has explicitly opted out. */
+    isOptedOut(): boolean;
+    /** Force-send all queued events immediately. Useful in tests. */
+    flush(): Promise<void>;
+    /** Get the current anonymous ID. */
+    getAnonymousId(): string;
+    /** Get the current session ID. */
+    getSessionId(): string;
+    /** Get the resolved configuration (read-only). */
+    getConfig(): Readonly<ResolvedConfig>;
+    /**
+     * Enable auto-tracking of SPA navigation.
+     * Returns a cleanup function to remove the listeners.
+     *
+     * @example
+     * const cleanup = bob.enableAutoPage()
+     * // Later: cleanup()
+     */
+    enableAutoPage(): () => void;
+    private buildEvent;
+}
+
+export { type DeviceType, type EventContext, type EventType, IndieBob, type PageOverrides, type RevenueData, type RevenueType, type TrackerConfig, type TrackerEvent, type UtmData };

package/dist/index.global.js

@@ -0,0 +1,2 @@
+var IndieBob=(function(exports){'use strict';var J=Object.defineProperty,z=Object.defineProperties;var G=Object.getOwnPropertyDescriptors;var k=Object.getOwnPropertySymbols;var W=Object.prototype.hasOwnProperty,Z=Object.prototype.propertyIsEnumerable;var A=(e,t,o)=>t in e?J(e,t,{enumerable:true,configurable:true,writable:true,value:o}):e[t]=o,d=(e,t)=>{for(var o in t||(t={}))W.call(t,o)&&A(e,o,t[o]);if(k)for(var o of k(t))Z.call(t,o)&&A(e,o,t[o]);return e},x=(e,t)=>z(e,G(t));var a=(e,t,o)=>new Promise((n,i)=>{var r=s=>{try{l(o.next(s));}catch(c){i(c);}},g=s=>{try{l(o.throw(s));}catch(c){i(c);}},l=s=>s.done?n(s.value):Promise.resolve(s.value).then(r,g);l((o=o.apply(e,t)).next());});var $="https://indiebob.com/api/collect";function D(e){var t,o,n,i;if(!e.projectId||!e.projectId.startsWith("proj_"))throw new Error(`[IndieBob] Invalid projectId "${e.projectId}". Must start with "proj_".`);return {projectId:e.projectId,endpoint:(t=e.endpoint)!=null?t:$,debug:(o=e.debug)!=null?o:false,respectDnt:(n=e.respectDnt)!=null?n:true,respectGpc:(i=e.respectGpc)!=null?i:true}}var u="_ib_anon";function h(){let e="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_-",t="";if(typeof crypto!="undefined"&&crypto.getRandomValues){let o=new Uint8Array(21);crypto.getRandomValues(o);for(let n of o)t+=e[n%e.length];}else for(let o=0;o<21;o++)t+=e[Math.floor(Math.random()*e.length)];return t}function v(){try{let e=localStorage.getItem(u);return e||(e=h(),localStorage.setItem(u,e)),e}catch(e){try{let t=sessionStorage.getItem(u);return t||(t=h(),sessionStorage.setItem(u,t)),t}catch(t){return h()}}}function P(){try{localStorage.removeItem(u);}catch(e){}try{sessionStorage.removeItem(u);}catch(e){}}var y="_ib_session",I="_ib_session_last";function N(){try{return crypto.randomUUID()}catch(e){return Math.random().toString(36).slice(2)+Math.random().toString(36).slice(2)}}function S(){var e;try{let t=Date.now(),o=parseInt((e=sessionStorage.getItem(I))!=null?e:"0",10),n=sessionStorage.getItem(y),i=o>0&&t-o>18e5;return (!n||i)&&(n=N(),sessionStorage.setItem(y,n)),sessionStorage.setItem(I,String(t)),n}catch(t){return N()}}function U(){try{sessionStorage.removeItem(y);}catch(e){}try{sessionStorage.removeItem(I);}catch(e){}}var b="_ib_first_utm",M="_ib_last_utm",_="_ib_referrer";function q(e){let t=new URLSearchParams(e),o={},n=false;return t.has("utm_source")&&(o.source=t.get("utm_source"),n=true),t.has("utm_medium")&&(o.medium=t.get("utm_medium"),n=true),t.has("utm_campaign")&&(o.campaign=t.get("utm_campaign"),n=true),t.has("utm_term")&&(o.term=t.get("utm_term"),n=true),t.has("utm_content")&&(o.content=t.get("utm_content"),n=true),n?o:null}function B(e,t){let o=q(e);try{o&&!localStorage.getItem(b)&&localStorage.setItem(b,JSON.stringify(o)),o&&localStorage.setItem(M,JSON.stringify(o)),t&&!localStorage.getItem(_)&&localStorage.setItem(_,t);}catch(n){}}function F(e){var t;return (t=q(e))!=null?t:void 0}function L(){try{localStorage.removeItem(b);}catch(e){}try{localStorage.removeItem(M);}catch(e){}try{localStorage.removeItem(_);}catch(e){}}var p="_ib_optout",tt="_ib_queue";function f(e){try{if(localStorage.getItem(p))return !1}catch(t){}return !(e.respectDnt&&typeof navigator!="undefined"&&(navigator.doNotTrack==="1"||navigator.msDoNotTrack==="1")||e.respectGpc&&typeof navigator!="undefined"&&navigator.globalPrivacyControl===true)}function j(){try{localStorage.setItem(p,"1");}catch(e){}P(),U(),L();try{localStorage.removeItem(tt);}catch(e){}}function Y(){try{localStorage.removeItem(p);}catch(e){}}function K(){try{return !!localStorage.getItem(p)}catch(e){return  false}}var et=[1e3,2e3,4e3];function ot(e){return a(this,null,function*(){return new Promise(t=>setTimeout(t,e))})}function w(e,t,o=false){return a(this,null,function*(){let n=JSON.stringify(e);if(o&&typeof navigator!="undefined"&&navigator.sendBeacon){let i=new Blob([n],{type:"application/json"}),r=navigator.sendBeacon(t.endpoint,i);return t.debug&&console.log("[IndieBob] sendBeacon:",r,e.batch.length,"events"),r}for(let i=0;i<3;i++){try{let r=yield fetch(t.endpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:n,keepalive:!0});if(r.ok)return t.debug&&console.log("[IndieBob] sent:",e.batch.length,"events"),!0;if(r.status>=400&&r.status<500)return t.debug&&console.warn("[IndieBob] 4xx error, not retrying:",r.status),!1}catch(r){t.debug&&console.warn("[IndieBob] fetch error (attempt",i+1,"):",r);}i<2&&(yield ot(et[i]));}return t.debug&&console.warn("[IndieBob] failed to send after",3,"attempts"),false})}var E="_ib_queue",nt=10,it=5e3,rt=50,m=class{constructor(t){this.queue=[];this.timer=null;this.flushing=false;this.config=t,this.startTimer(),this.setupVisibilityFlush(),this.setupOnlineFlush();}push(t){this.queue.push(t),this.queue.length>=nt&&this.flush();}flush(t=false){return a(this,null,function*(){if(this.flushing&&!t||this.queue.length===0)return;this.flushing=true;let o=this.queue.splice(0);(yield w({batch:o},this.config,t))||this.pushToOfflineQueue(o),this.flushing=false;})}flushOfflineQueue(){return a(this,null,function*(){let t=this.getOfflineQueue();if(t.length===0)return;this.clearOfflineQueue(),yield w({batch:t},this.config);})}destroy(){this.timer&&clearInterval(this.timer);}startTimer(){this.timer=setInterval(()=>{this.queue.length>0&&this.flush();},it);}setupVisibilityFlush(){typeof document!="undefined"&&document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flush(true);},{passive:true});}setupOnlineFlush(){typeof window!="undefined"&&(window.addEventListener("online",()=>{this.flushOfflineQueue();}),navigator.onLine&&this.flushOfflineQueue());}pushToOfflineQueue(t){try{let i=[...this.getOfflineQueue(),...t].slice(-rt);localStorage.setItem(E,JSON.stringify(i));}catch(o){}}getOfflineQueue(){try{let t=localStorage.getItem(E);return t?JSON.parse(t):[]}catch(t){return []}}clearOfflineQueue(){try{localStorage.removeItem(E);}catch(t){}}};function Q(){if(typeof window=="undefined")return "desktop";let e=window.innerWidth;return e<=768?"mobile":e<=1024?"tablet":"desktop"}function V(){return typeof window=="undefined"?{width:0,height:0}:{width:window.innerWidth,height:window.innerHeight}}function T(e){var c,O,R,C;let t=typeof window=="undefined",o=(c=e==null?void 0:e.path)!=null?c:t?"":window.location.pathname+window.location.search,n=t?"":window.location.href,i=(O=e==null?void 0:e.title)!=null?O:t?"":document.title,r=(R=e==null?void 0:e.referrer)!=null?R:t?"":document.referrer,g=V(),l=Q(),s=t?void 0:F(window.location.search);return {page:{path:o,url:n,title:i,referrer:r},device:x(d({},g),{type:l}),utm:s,locale:t?"en":navigator.language,timezone:t?"UTC":(C=Intl.DateTimeFormat().resolvedOptions().timeZone)!=null?C:"UTC",sdkVersion:"0.1.0"}}function H(e){if(typeof window=="undefined")return ()=>{};let t=history.pushState.bind(history),o=history.replaceState.bind(history);return history.pushState=function(...n){t(...n),e();},history.replaceState=function(...n){o(...n);},window.addEventListener("popstate",e),()=>{history.pushState=t,history.replaceState=o,window.removeEventListener("popstate",e);}}var X=class e{constructor(t){this.cleanupHistory=null;this.config=t,this.queue=new m(t),typeof window!="undefined"&&B(window.location.search,document.referrer);}static init(t){let o=D(t);return new e(o)}page(t){f(this.config)&&this.queue.push(this.buildEvent("page",{context:T(t)}));}track(t,o){f(this.config)&&this.queue.push(this.buildEvent("track",{event:t,properties:o}));}identify(t,o){f(this.config)&&(this.userId=t,this.queue.push(this.buildEvent("identify",{traits:o,userId:t})));}revenue(t){var o;f(this.config)&&this.queue.push(this.buildEvent("revenue",{revenue:{amount:t.amount,currency:(o=t.currency)!=null?o:"USD",plan:t.plan,type:t.type}}));}optOut(){this.queue.flush(),j(),this.userId=void 0,this.config.debug&&console.log("[IndieBob] opted out");}optIn(){Y(),this.config.debug&&console.log("[IndieBob] opted in");}isOptedOut(){return K()}flush(){return a(this,null,function*(){yield this.queue.flush();})}getAnonymousId(){return v()}getSessionId(){return S()}getConfig(){return Object.freeze(d({},this.config))}enableAutoPage(){var t;return (t=this.cleanupHistory)==null||t.call(this),this.cleanupHistory=H(()=>this.page()),()=>{var o;(o=this.cleanupHistory)==null||o.call(this),this.cleanupHistory=null;}}buildEvent(t,o){var n,i;return {v:1,projectId:this.config.projectId,type:t,anonymousId:v(),userId:(n=this.userId)!=null?n:o.userId,sessionId:S(),timestamp:new Date().toISOString(),context:(i=o.context)!=null?i:T(),event:o.event,properties:o.properties,traits:o.traits,revenue:o.revenue}}};
+exports.IndieBob=X;return exports;})({});

package/dist/index.js

@@ -0,0 +1 @@
+export{a as IndieBob}from'./chunk-XKQYO25W.js';

package/dist/server.d.mts

@@ -0,0 +1,39 @@
+/**
+ * Configuration for the IndieBob tracker.
+ */
+interface TrackerConfig {
+    /** Your SDK project ID from the IndieBob dashboard. Format: 'proj_...' */
+    projectId: string;
+    /** Ingestion endpoint URL. Default: 'https://indiebob.com/api/collect' */
+    endpoint?: string;
+    /** Log all events to the browser console. Default: false */
+    debug?: boolean;
+    /** Honor the browser Do Not Track header. Default: true */
+    respectDnt?: boolean;
+    /** Honor Global Privacy Control signal (legally binding in CA/GDPR). Default: true */
+    respectGpc?: boolean;
+}
+
+/**
+ * Server-side tracker for Node.js environments.
+ * No browser APIs are used here.
+ */
+
+/**
+ * Server-side IndieBob tracker. Use this in Node.js/Nuxt server routes.
+ *
+ * @example
+ * const bob = IndieBob.initServer({ projectId: 'proj_abc123def456ghij' })
+ * bob.track('server_event', { source: 'webhook' })
+ */
+declare class IndieBobServer {
+    private config;
+    private constructor();
+    static initServer(config: TrackerConfig): IndieBobServer;
+    track(event: string, properties?: Record<string, unknown>, userId?: string): Promise<boolean>;
+    identify(userId: string, traits?: Record<string, unknown>): Promise<boolean>;
+    private buildEvent;
+}
+declare const IndieBob: typeof IndieBobServer;
+
+export { IndieBob, IndieBobServer };

package/dist/server.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Configuration for the IndieBob tracker.
+ */
+interface TrackerConfig {
+    /** Your SDK project ID from the IndieBob dashboard. Format: 'proj_...' */
+    projectId: string;
+    /** Ingestion endpoint URL. Default: 'https://indiebob.com/api/collect' */
+    endpoint?: string;
+    /** Log all events to the browser console. Default: false */
+    debug?: boolean;
+    /** Honor the browser Do Not Track header. Default: true */
+    respectDnt?: boolean;
+    /** Honor Global Privacy Control signal (legally binding in CA/GDPR). Default: true */
+    respectGpc?: boolean;
+}
+
+/**
+ * Server-side tracker for Node.js environments.
+ * No browser APIs are used here.
+ */
+
+/**
+ * Server-side IndieBob tracker. Use this in Node.js/Nuxt server routes.
+ *
+ * @example
+ * const bob = IndieBob.initServer({ projectId: 'proj_abc123def456ghij' })
+ * bob.track('server_event', { source: 'webhook' })
+ */
+declare class IndieBobServer {
+    private config;
+    private constructor();
+    static initServer(config: TrackerConfig): IndieBobServer;
+    track(event: string, properties?: Record<string, unknown>, userId?: string): Promise<boolean>;
+    identify(userId: string, traits?: Record<string, unknown>): Promise<boolean>;
+    private buildEvent;
+}
+declare const IndieBob: typeof IndieBobServer;
+
+export { IndieBob, IndieBobServer };

package/dist/server.js

@@ -0,0 +1,93 @@
+'use strict';
+
+// src/core/config.ts
+var DEFAULT_ENDPOINT = "https://indiebob.com/api/collect";
+function resolveConfig(input) {
+  if (!input.projectId || !input.projectId.startsWith("proj_")) {
+    throw new Error(
+      `[IndieBob] Invalid projectId "${input.projectId}". Must start with "proj_".`
+    );
+  }
+  return {
+    projectId: input.projectId,
+    endpoint: input.endpoint ?? DEFAULT_ENDPOINT,
+    debug: input.debug ?? false,
+    respectDnt: input.respectDnt ?? true,
+    respectGpc: input.respectGpc ?? true
+  };
+}
+
+// src/core/transport.ts
+var MAX_RETRIES = 3;
+var RETRY_DELAYS = [1e3, 2e3, 4e3];
+async function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function sendBatchServer(payload, config) {
+  for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+    try {
+      const res = await fetch(config.endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload)
+      });
+      if (res.ok) return true;
+      if (res.status >= 400 && res.status < 500) return false;
+    } catch {
+    }
+    if (attempt < MAX_RETRIES - 1) await sleep(RETRY_DELAYS[attempt]);
+  }
+  return false;
+}
+
+// src/integrations/server.ts
+function generateId() {
+  try {
+    return crypto.randomUUID();
+  } catch {
+    return Math.random().toString(36).slice(2) + Math.random().toString(36).slice(2);
+  }
+}
+var IndieBobServer = class _IndieBobServer {
+  constructor(config) {
+    this.config = config;
+  }
+  static initServer(config) {
+    return new _IndieBobServer(resolveConfig(config));
+  }
+  track(event, properties, userId) {
+    return sendBatchServer({
+      batch: [this.buildEvent("track", { event, properties, userId })]
+    }, this.config);
+  }
+  identify(userId, traits) {
+    return sendBatchServer({
+      batch: [this.buildEvent("identify", { traits, userId })]
+    }, this.config);
+  }
+  buildEvent(type, extras) {
+    return {
+      v: 1,
+      projectId: this.config.projectId,
+      type,
+      anonymousId: `server_${generateId()}`,
+      userId: extras.userId,
+      sessionId: `server_${generateId()}`,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      context: {
+        page: { path: "", url: "", title: "", referrer: "" },
+        device: { width: 0, height: 0, type: "desktop" },
+        locale: "en",
+        timezone: "UTC",
+        sdkVersion: "0.1.0" 
+      },
+      event: extras.event,
+      properties: extras.properties,
+      traits: extras.traits
+    };
+  }
+};
+var IndieBob = IndieBobServer;
+
+exports.IndieBob = IndieBob;
+exports.IndieBobServer = IndieBobServer;

package/dist/server.mjs

@@ -0,0 +1,90 @@
+// src/core/config.ts
+var DEFAULT_ENDPOINT = "https://indiebob.com/api/collect";
+function resolveConfig(input) {
+  if (!input.projectId || !input.projectId.startsWith("proj_")) {
+    throw new Error(
+      `[IndieBob] Invalid projectId "${input.projectId}". Must start with "proj_".`
+    );
+  }
+  return {
+    projectId: input.projectId,
+    endpoint: input.endpoint ?? DEFAULT_ENDPOINT,
+    debug: input.debug ?? false,
+    respectDnt: input.respectDnt ?? true,
+    respectGpc: input.respectGpc ?? true
+  };
+}
+
+// src/core/transport.ts
+var MAX_RETRIES = 3;
+var RETRY_DELAYS = [1e3, 2e3, 4e3];
+async function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function sendBatchServer(payload, config) {
+  for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+    try {
+      const res = await fetch(config.endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload)
+      });
+      if (res.ok) return true;
+      if (res.status >= 400 && res.status < 500) return false;
+    } catch {
+    }
+    if (attempt < MAX_RETRIES - 1) await sleep(RETRY_DELAYS[attempt]);
+  }
+  return false;
+}
+
+// src/integrations/server.ts
+function generateId() {
+  try {
+    return crypto.randomUUID();
+  } catch {
+    return Math.random().toString(36).slice(2) + Math.random().toString(36).slice(2);
+  }
+}
+var IndieBobServer = class _IndieBobServer {
+  constructor(config) {
+    this.config = config;
+  }
+  static initServer(config) {
+    return new _IndieBobServer(resolveConfig(config));
+  }
+  track(event, properties, userId) {
+    return sendBatchServer({
+      batch: [this.buildEvent("track", { event, properties, userId })]
+    }, this.config);
+  }
+  identify(userId, traits) {
+    return sendBatchServer({
+      batch: [this.buildEvent("identify", { traits, userId })]
+    }, this.config);
+  }
+  buildEvent(type, extras) {
+    return {
+      v: 1,
+      projectId: this.config.projectId,
+      type,
+      anonymousId: `server_${generateId()}`,
+      userId: extras.userId,
+      sessionId: `server_${generateId()}`,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      context: {
+        page: { path: "", url: "", title: "", referrer: "" },
+        device: { width: 0, height: 0, type: "desktop" },
+        locale: "en",
+        timezone: "UTC",
+        sdkVersion: "0.1.0" 
+      },
+      event: extras.event,
+      properties: extras.properties,
+      traits: extras.traits
+    };
+  }
+};
+var IndieBob = IndieBobServer;
+
+export { IndieBob, IndieBobServer };

package/dist/vue.cjs

@@ -0,0 +1,2 @@
+'use strict';var z=Object.defineProperty,G=Object.defineProperties;var W=Object.getOwnPropertyDescriptors;var x=Object.getOwnPropertySymbols;var $=Object.prototype.hasOwnProperty,Z=Object.prototype.propertyIsEnumerable;var P=(t,e,o)=>e in t?z(t,e,{enumerable:true,configurable:true,writable:true,value:o}):t[e]=o,d=(t,e)=>{for(var o in e||(e={}))$.call(e,o)&&P(t,o,e[o]);if(x)for(var o of x(e))Z.call(e,o)&&P(t,o,e[o]);return t},D=(t,e)=>G(t,W(e));var a=(t,e,o)=>new Promise((n,r)=>{var i=s=>{try{l(o.next(s));}catch(u){r(u);}},h=s=>{try{l(o.throw(s));}catch(u){r(u);}},l=s=>s.done?n(s.value):Promise.resolve(s.value).then(i,h);l((o=o.apply(t,e)).next());});var ee="https://indiebob.com/api/collect";function N(t){var e,o,n,r;if(!t.projectId||!t.projectId.startsWith("proj_"))throw new Error(`[IndieBob] Invalid projectId "${t.projectId}". Must start with "proj_".`);return {projectId:t.projectId,endpoint:(e=t.endpoint)!=null?e:ee,debug:(o=t.debug)!=null?o:false,respectDnt:(n=t.respectDnt)!=null?n:true,respectGpc:(r=t.respectGpc)!=null?r:true}}var c="_ib_anon";function y(){let t="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_-",e="";if(typeof crypto!="undefined"&&crypto.getRandomValues){let o=new Uint8Array(21);crypto.getRandomValues(o);for(let n of o)e+=t[n%t.length];}else for(let o=0;o<21;o++)e+=t[Math.floor(Math.random()*t.length)];return e}function v(){try{let t=localStorage.getItem(c);return t||(t=y(),localStorage.setItem(c,t)),t}catch(t){try{let e=sessionStorage.getItem(c);return e||(e=y(),sessionStorage.setItem(c,e)),e}catch(e){return y()}}}function B(){try{localStorage.removeItem(c);}catch(t){}try{sessionStorage.removeItem(c);}catch(t){}}var I="_ib_session",S="_ib_session_last";function U(){try{return crypto.randomUUID()}catch(t){return Math.random().toString(36).slice(2)+Math.random().toString(36).slice(2)}}function b(){var t;try{let e=Date.now(),o=parseInt((t=sessionStorage.getItem(S))!=null?t:"0",10),n=sessionStorage.getItem(I),r=o>0&&e-o>18e5;return (!n||r)&&(n=U(),sessionStorage.setItem(I,n)),sessionStorage.setItem(S,String(e)),n}catch(e){return U()}}function M(){try{sessionStorage.removeItem(I);}catch(t){}try{sessionStorage.removeItem(S);}catch(t){}}var _="_ib_first_utm",q="_ib_last_utm",T="_ib_referrer";function F(t){let e=new URLSearchParams(t),o={},n=false;return e.has("utm_source")&&(o.source=e.get("utm_source"),n=true),e.has("utm_medium")&&(o.medium=e.get("utm_medium"),n=true),e.has("utm_campaign")&&(o.campaign=e.get("utm_campaign"),n=true),e.has("utm_term")&&(o.term=e.get("utm_term"),n=true),e.has("utm_content")&&(o.content=e.get("utm_content"),n=true),n?o:null}function L(t,e){let o=F(t);try{o&&!localStorage.getItem(_)&&localStorage.setItem(_,JSON.stringify(o)),o&&localStorage.setItem(q,JSON.stringify(o)),e&&!localStorage.getItem(T)&&localStorage.setItem(T,e);}catch(n){}}function j(t){var e;return (e=F(t))!=null?e:void 0}function Y(){try{localStorage.removeItem(_);}catch(t){}try{localStorage.removeItem(q);}catch(t){}try{localStorage.removeItem(T);}catch(t){}}var p="_ib_optout",te="_ib_queue";function f(t){try{if(localStorage.getItem(p))return !1}catch(e){}return !(t.respectDnt&&typeof navigator!="undefined"&&(navigator.doNotTrack==="1"||navigator.msDoNotTrack==="1")||t.respectGpc&&typeof navigator!="undefined"&&navigator.globalPrivacyControl===true)}function K(){try{localStorage.setItem(p,"1");}catch(t){}B(),M(),Y();try{localStorage.removeItem(te);}catch(t){}}function Q(){try{localStorage.removeItem(p);}catch(t){}}function V(){try{return !!localStorage.getItem(p)}catch(t){return  false}}var oe=[1e3,2e3,4e3];function ne(t){return a(this,null,function*(){return new Promise(e=>setTimeout(e,t))})}function E(t,e,o=false){return a(this,null,function*(){let n=JSON.stringify(t);if(o&&typeof navigator!="undefined"&&navigator.sendBeacon){let r=new Blob([n],{type:"application/json"}),i=navigator.sendBeacon(e.endpoint,r);return e.debug&&console.log("[IndieBob] sendBeacon:",i,t.batch.length,"events"),i}for(let r=0;r<3;r++){try{let i=yield fetch(e.endpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:n,keepalive:!0});if(i.ok)return e.debug&&console.log("[IndieBob] sent:",t.batch.length,"events"),!0;if(i.status>=400&&i.status<500)return e.debug&&console.warn("[IndieBob] 4xx error, not retrying:",i.status),!1}catch(i){e.debug&&console.warn("[IndieBob] fetch error (attempt",r+1,"):",i);}r<2&&(yield ne(oe[r]));}return e.debug&&console.warn("[IndieBob] failed to send after",3,"attempts"),false})}var w="_ib_queue",re=10,ie=5e3,se=50,m=class{constructor(e){this.queue=[];this.timer=null;this.flushing=false;this.config=e,this.startTimer(),this.setupVisibilityFlush(),this.setupOnlineFlush();}push(e){this.queue.push(e),this.queue.length>=re&&this.flush();}flush(e=false){return a(this,null,function*(){if(this.flushing&&!e||this.queue.length===0)return;this.flushing=true;let o=this.queue.splice(0);(yield E({batch:o},this.config,e))||this.pushToOfflineQueue(o),this.flushing=false;})}flushOfflineQueue(){return a(this,null,function*(){let e=this.getOfflineQueue();if(e.length===0)return;this.clearOfflineQueue(),yield E({batch:e},this.config);})}destroy(){this.timer&&clearInterval(this.timer);}startTimer(){this.timer=setInterval(()=>{this.queue.length>0&&this.flush();},ie);}setupVisibilityFlush(){typeof document!="undefined"&&document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flush(true);},{passive:true});}setupOnlineFlush(){typeof window!="undefined"&&(window.addEventListener("online",()=>{this.flushOfflineQueue();}),navigator.onLine&&this.flushOfflineQueue());}pushToOfflineQueue(e){try{let r=[...this.getOfflineQueue(),...e].slice(-se);localStorage.setItem(w,JSON.stringify(r));}catch(o){}}getOfflineQueue(){try{let e=localStorage.getItem(w);return e?JSON.parse(e):[]}catch(e){return []}}clearOfflineQueue(){try{localStorage.removeItem(w);}catch(e){}}};function H(){if(typeof window=="undefined")return "desktop";let t=window.innerWidth;return t<=768?"mobile":t<=1024?"tablet":"desktop"}function X(){return typeof window=="undefined"?{width:0,height:0}:{width:window.innerWidth,height:window.innerHeight}}function R(t){var u,C,k,A;let e=typeof window=="undefined",o=(u=t==null?void 0:t.path)!=null?u:e?"":window.location.pathname+window.location.search,n=e?"":window.location.href,r=(C=t==null?void 0:t.title)!=null?C:e?"":document.title,i=(k=t==null?void 0:t.referrer)!=null?k:e?"":document.referrer,h=X(),l=H(),s=e?void 0:j(window.location.search);return {page:{path:o,url:n,title:r,referrer:i},device:D(d({},h),{type:l}),utm:s,locale:e?"en":navigator.language,timezone:e?"UTC":(A=Intl.DateTimeFormat().resolvedOptions().timeZone)!=null?A:"UTC",sdkVersion:"0.1.0"}}function J(t){if(typeof window=="undefined")return ()=>{};let e=history.pushState.bind(history),o=history.replaceState.bind(history);return history.pushState=function(...n){e(...n),t();},history.replaceState=function(...n){o(...n);},window.addEventListener("popstate",t),()=>{history.pushState=e,history.replaceState=o,window.removeEventListener("popstate",t);}}var g=class t{constructor(e){this.cleanupHistory=null;this.config=e,this.queue=new m(e),typeof window!="undefined"&&L(window.location.search,document.referrer);}static init(e){let o=N(e);return new t(o)}page(e){f(this.config)&&this.queue.push(this.buildEvent("page",{context:R(e)}));}track(e,o){f(this.config)&&this.queue.push(this.buildEvent("track",{event:e,properties:o}));}identify(e,o){f(this.config)&&(this.userId=e,this.queue.push(this.buildEvent("identify",{traits:o,userId:e})));}revenue(e){var o;f(this.config)&&this.queue.push(this.buildEvent("revenue",{revenue:{amount:e.amount,currency:(o=e.currency)!=null?o:"USD",plan:e.plan,type:e.type}}));}optOut(){this.queue.flush(),K(),this.userId=void 0,this.config.debug&&console.log("[IndieBob] opted out");}optIn(){Q(),this.config.debug&&console.log("[IndieBob] opted in");}isOptedOut(){return V()}flush(){return a(this,null,function*(){yield this.queue.flush();})}getAnonymousId(){return v()}getSessionId(){return b()}getConfig(){return Object.freeze(d({},this.config))}enableAutoPage(){var e;return (e=this.cleanupHistory)==null||e.call(this),this.cleanupHistory=J(()=>this.page()),()=>{var o;(o=this.cleanupHistory)==null||o.call(this),this.cleanupHistory=null;}}buildEvent(e,o){var n,r;return {v:1,projectId:this.config.projectId,type:e,anonymousId:v(),userId:(n=this.userId)!=null?n:o.userId,sessionId:b(),timestamp:new Date().toISOString(),context:(r=o.context)!=null?r:R(),event:o.event,properties:o.properties,traits:o.traits,revenue:o.revenue}}};var ae=Symbol("indiebob"),O=null,Fe={install(t,e){let o=g.init(e);O=o,t.provide(ae,o),t.config.globalProperties.$bob=o;let n=t.config.globalProperties.$router;n&&n.afterEach(()=>{o.page();});}};function Le(){if(O)return O;throw new Error("[IndieBob] useTracker() called before IndieBobPlugin was installed.")}
+exports.IndieBob=g;exports.IndieBobPlugin=Fe;exports.useTracker=Le;

package/dist/vue.d.mts

@@ -0,0 +1,29 @@
+import { Plugin } from 'vue';
+import { IndieBob } from './index.mjs';
+
+/**
+ * Vue plugin for @indiebob/tracker.
+ *
+ * @example
+ * // main.ts
+ * app.use(IndieBobPlugin, { projectId: 'proj_abc123def456ghij' })
+ *
+ * @example
+ * // Nuxt plugin (plugins/tracker.client.ts)
+ * export default defineNuxtPlugin((nuxtApp) => {
+ *   nuxtApp.vueApp.use(IndieBobPlugin, {
+ *     projectId: useRuntimeConfig().public.trackerProjectId,
+ *   })
+ * })
+ */
+declare const IndieBobPlugin: Plugin;
+/**
+ * Get the IndieBob tracker instance inside a Vue component or composable.
+ *
+ * @example
+ * const bob = useTracker()
+ * bob.track('button_clicked', { button: 'cta_hero' })
+ */
+declare function useTracker(): IndieBob;
+
+export { IndieBob, IndieBobPlugin, useTracker };

package/dist/vue.d.ts

@@ -0,0 +1,29 @@
+import { Plugin } from 'vue';
+import { IndieBob } from './index.js';
+
+/**
+ * Vue plugin for @indiebob/tracker.
+ *
+ * @example
+ * // main.ts
+ * app.use(IndieBobPlugin, { projectId: 'proj_abc123def456ghij' })
+ *
+ * @example
+ * // Nuxt plugin (plugins/tracker.client.ts)
+ * export default defineNuxtPlugin((nuxtApp) => {
+ *   nuxtApp.vueApp.use(IndieBobPlugin, {
+ *     projectId: useRuntimeConfig().public.trackerProjectId,
+ *   })
+ * })
+ */
+declare const IndieBobPlugin: Plugin;
+/**
+ * Get the IndieBob tracker instance inside a Vue component or composable.
+ *
+ * @example
+ * const bob = useTracker()
+ * bob.track('button_clicked', { button: 'cta_hero' })
+ */
+declare function useTracker(): IndieBob;
+
+export { IndieBob, IndieBobPlugin, useTracker };

package/dist/vue.global.js

@@ -0,0 +1,2 @@
+var IndieBob=(function(exports){'use strict';var z=Object.defineProperty,G=Object.defineProperties;var W=Object.getOwnPropertyDescriptors;var x=Object.getOwnPropertySymbols;var $=Object.prototype.hasOwnProperty,Z=Object.prototype.propertyIsEnumerable;var P=(t,e,o)=>e in t?z(t,e,{enumerable:true,configurable:true,writable:true,value:o}):t[e]=o,d=(t,e)=>{for(var o in e||(e={}))$.call(e,o)&&P(t,o,e[o]);if(x)for(var o of x(e))Z.call(e,o)&&P(t,o,e[o]);return t},D=(t,e)=>G(t,W(e));var a=(t,e,o)=>new Promise((n,r)=>{var i=s=>{try{l(o.next(s));}catch(u){r(u);}},h=s=>{try{l(o.throw(s));}catch(u){r(u);}},l=s=>s.done?n(s.value):Promise.resolve(s.value).then(i,h);l((o=o.apply(t,e)).next());});var ee="https://indiebob.com/api/collect";function N(t){var e,o,n,r;if(!t.projectId||!t.projectId.startsWith("proj_"))throw new Error(`[IndieBob] Invalid projectId "${t.projectId}". Must start with "proj_".`);return {projectId:t.projectId,endpoint:(e=t.endpoint)!=null?e:ee,debug:(o=t.debug)!=null?o:false,respectDnt:(n=t.respectDnt)!=null?n:true,respectGpc:(r=t.respectGpc)!=null?r:true}}var c="_ib_anon";function y(){let t="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_-",e="";if(typeof crypto!="undefined"&&crypto.getRandomValues){let o=new Uint8Array(21);crypto.getRandomValues(o);for(let n of o)e+=t[n%t.length];}else for(let o=0;o<21;o++)e+=t[Math.floor(Math.random()*t.length)];return e}function v(){try{let t=localStorage.getItem(c);return t||(t=y(),localStorage.setItem(c,t)),t}catch(t){try{let e=sessionStorage.getItem(c);return e||(e=y(),sessionStorage.setItem(c,e)),e}catch(e){return y()}}}function B(){try{localStorage.removeItem(c);}catch(t){}try{sessionStorage.removeItem(c);}catch(t){}}var I="_ib_session",S="_ib_session_last";function U(){try{return crypto.randomUUID()}catch(t){return Math.random().toString(36).slice(2)+Math.random().toString(36).slice(2)}}function b(){var t;try{let e=Date.now(),o=parseInt((t=sessionStorage.getItem(S))!=null?t:"0",10),n=sessionStorage.getItem(I),r=o>0&&e-o>18e5;return (!n||r)&&(n=U(),sessionStorage.setItem(I,n)),sessionStorage.setItem(S,String(e)),n}catch(e){return U()}}function M(){try{sessionStorage.removeItem(I);}catch(t){}try{sessionStorage.removeItem(S);}catch(t){}}var _="_ib_first_utm",q="_ib_last_utm",T="_ib_referrer";function F(t){let e=new URLSearchParams(t),o={},n=false;return e.has("utm_source")&&(o.source=e.get("utm_source"),n=true),e.has("utm_medium")&&(o.medium=e.get("utm_medium"),n=true),e.has("utm_campaign")&&(o.campaign=e.get("utm_campaign"),n=true),e.has("utm_term")&&(o.term=e.get("utm_term"),n=true),e.has("utm_content")&&(o.content=e.get("utm_content"),n=true),n?o:null}function L(t,e){let o=F(t);try{o&&!localStorage.getItem(_)&&localStorage.setItem(_,JSON.stringify(o)),o&&localStorage.setItem(q,JSON.stringify(o)),e&&!localStorage.getItem(T)&&localStorage.setItem(T,e);}catch(n){}}function j(t){var e;return (e=F(t))!=null?e:void 0}function Y(){try{localStorage.removeItem(_);}catch(t){}try{localStorage.removeItem(q);}catch(t){}try{localStorage.removeItem(T);}catch(t){}}var p="_ib_optout",te="_ib_queue";function f(t){try{if(localStorage.getItem(p))return !1}catch(e){}return !(t.respectDnt&&typeof navigator!="undefined"&&(navigator.doNotTrack==="1"||navigator.msDoNotTrack==="1")||t.respectGpc&&typeof navigator!="undefined"&&navigator.globalPrivacyControl===true)}function K(){try{localStorage.setItem(p,"1");}catch(t){}B(),M(),Y();try{localStorage.removeItem(te);}catch(t){}}function Q(){try{localStorage.removeItem(p);}catch(t){}}function V(){try{return !!localStorage.getItem(p)}catch(t){return  false}}var oe=[1e3,2e3,4e3];function ne(t){return a(this,null,function*(){return new Promise(e=>setTimeout(e,t))})}function E(t,e,o=false){return a(this,null,function*(){let n=JSON.stringify(t);if(o&&typeof navigator!="undefined"&&navigator.sendBeacon){let r=new Blob([n],{type:"application/json"}),i=navigator.sendBeacon(e.endpoint,r);return e.debug&&console.log("[IndieBob] sendBeacon:",i,t.batch.length,"events"),i}for(let r=0;r<3;r++){try{let i=yield fetch(e.endpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:n,keepalive:!0});if(i.ok)return e.debug&&console.log("[IndieBob] sent:",t.batch.length,"events"),!0;if(i.status>=400&&i.status<500)return e.debug&&console.warn("[IndieBob] 4xx error, not retrying:",i.status),!1}catch(i){e.debug&&console.warn("[IndieBob] fetch error (attempt",r+1,"):",i);}r<2&&(yield ne(oe[r]));}return e.debug&&console.warn("[IndieBob] failed to send after",3,"attempts"),false})}var w="_ib_queue",re=10,ie=5e3,se=50,m=class{constructor(e){this.queue=[];this.timer=null;this.flushing=false;this.config=e,this.startTimer(),this.setupVisibilityFlush(),this.setupOnlineFlush();}push(e){this.queue.push(e),this.queue.length>=re&&this.flush();}flush(e=false){return a(this,null,function*(){if(this.flushing&&!e||this.queue.length===0)return;this.flushing=true;let o=this.queue.splice(0);(yield E({batch:o},this.config,e))||this.pushToOfflineQueue(o),this.flushing=false;})}flushOfflineQueue(){return a(this,null,function*(){let e=this.getOfflineQueue();if(e.length===0)return;this.clearOfflineQueue(),yield E({batch:e},this.config);})}destroy(){this.timer&&clearInterval(this.timer);}startTimer(){this.timer=setInterval(()=>{this.queue.length>0&&this.flush();},ie);}setupVisibilityFlush(){typeof document!="undefined"&&document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flush(true);},{passive:true});}setupOnlineFlush(){typeof window!="undefined"&&(window.addEventListener("online",()=>{this.flushOfflineQueue();}),navigator.onLine&&this.flushOfflineQueue());}pushToOfflineQueue(e){try{let r=[...this.getOfflineQueue(),...e].slice(-se);localStorage.setItem(w,JSON.stringify(r));}catch(o){}}getOfflineQueue(){try{let e=localStorage.getItem(w);return e?JSON.parse(e):[]}catch(e){return []}}clearOfflineQueue(){try{localStorage.removeItem(w);}catch(e){}}};function H(){if(typeof window=="undefined")return "desktop";let t=window.innerWidth;return t<=768?"mobile":t<=1024?"tablet":"desktop"}function X(){return typeof window=="undefined"?{width:0,height:0}:{width:window.innerWidth,height:window.innerHeight}}function R(t){var u,C,k,A;let e=typeof window=="undefined",o=(u=t==null?void 0:t.path)!=null?u:e?"":window.location.pathname+window.location.search,n=e?"":window.location.href,r=(C=t==null?void 0:t.title)!=null?C:e?"":document.title,i=(k=t==null?void 0:t.referrer)!=null?k:e?"":document.referrer,h=X(),l=H(),s=e?void 0:j(window.location.search);return {page:{path:o,url:n,title:r,referrer:i},device:D(d({},h),{type:l}),utm:s,locale:e?"en":navigator.language,timezone:e?"UTC":(A=Intl.DateTimeFormat().resolvedOptions().timeZone)!=null?A:"UTC",sdkVersion:"0.1.0"}}function J(t){if(typeof window=="undefined")return ()=>{};let e=history.pushState.bind(history),o=history.replaceState.bind(history);return history.pushState=function(...n){e(...n),t();},history.replaceState=function(...n){o(...n);},window.addEventListener("popstate",t),()=>{history.pushState=e,history.replaceState=o,window.removeEventListener("popstate",t);}}var g=class t{constructor(e){this.cleanupHistory=null;this.config=e,this.queue=new m(e),typeof window!="undefined"&&L(window.location.search,document.referrer);}static init(e){let o=N(e);return new t(o)}page(e){f(this.config)&&this.queue.push(this.buildEvent("page",{context:R(e)}));}track(e,o){f(this.config)&&this.queue.push(this.buildEvent("track",{event:e,properties:o}));}identify(e,o){f(this.config)&&(this.userId=e,this.queue.push(this.buildEvent("identify",{traits:o,userId:e})));}revenue(e){var o;f(this.config)&&this.queue.push(this.buildEvent("revenue",{revenue:{amount:e.amount,currency:(o=e.currency)!=null?o:"USD",plan:e.plan,type:e.type}}));}optOut(){this.queue.flush(),K(),this.userId=void 0,this.config.debug&&console.log("[IndieBob] opted out");}optIn(){Q(),this.config.debug&&console.log("[IndieBob] opted in");}isOptedOut(){return V()}flush(){return a(this,null,function*(){yield this.queue.flush();})}getAnonymousId(){return v()}getSessionId(){return b()}getConfig(){return Object.freeze(d({},this.config))}enableAutoPage(){var e;return (e=this.cleanupHistory)==null||e.call(this),this.cleanupHistory=J(()=>this.page()),()=>{var o;(o=this.cleanupHistory)==null||o.call(this),this.cleanupHistory=null;}}buildEvent(e,o){var n,r;return {v:1,projectId:this.config.projectId,type:e,anonymousId:v(),userId:(n=this.userId)!=null?n:o.userId,sessionId:b(),timestamp:new Date().toISOString(),context:(r=o.context)!=null?r:R(),event:o.event,properties:o.properties,traits:o.traits,revenue:o.revenue}}};var ae=Symbol("indiebob"),O=null,Fe={install(t,e){let o=g.init(e);O=o,t.provide(ae,o),t.config.globalProperties.$bob=o;let n=t.config.globalProperties.$router;n&&n.afterEach(()=>{o.page();});}};function Le(){if(O)return O;throw new Error("[IndieBob] useTracker() called before IndieBobPlugin was installed.")}
+exports.IndieBob=g;exports.IndieBobPlugin=Fe;exports.useTracker=Le;return exports;})({});

package/dist/vue.js

@@ -0,0 +1 @@
+import {a}from'./chunk-XKQYO25W.js';export{a as IndieBob}from'./chunk-XKQYO25W.js';var l=Symbol("indiebob"),r=null,b={install(o,n){let e=a.init(n);r=e,o.provide(l,e),o.config.globalProperties.$bob=e;let t=o.config.globalProperties.$router;t&&t.afterEach(()=>{e.page();});}};function p(){if(r)return r;throw new Error("[IndieBob] useTracker() called before IndieBobPlugin was installed.")}export{b as IndieBobPlugin,p as useTracker};

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@indiebob/tracker",
+  "version": "0.1.0",
+  "description": "Privacy-first analytics SDK for web applications. <5KB gzipped. No cookies.",
+  "private": false,
+  "license": "MIT",
+  "author": "IndieBob <hello@indiebob.com>",
+  "homepage": "https://indiebob.com/docs/sdk",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/indiebob/indiebob-monorepo.git",
+    "directory": "packages/tracker"
+  },
+  "keywords": [
+    "analytics",
+    "tracking",
+    "privacy",
+    "sdk",
+    "web-analytics",
+    "event-tracking",
+    "utm",
+    "attribution",
+    "vue",
+    "nuxt"
+  ],
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "browser": "./dist/index.global.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./vue": {
+      "types": "./dist/vue.d.ts",
+      "import": "./dist/vue.js",
+      "require": "./dist/vue.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "cdn:publish": "tsx scripts/publish-cdn.mts",
+    "prepublishOnly": "pnpm run build"
+  },
+  "devDependencies": {
+    "@aws-sdk/client-s3": "^3.1000.0",
+    "@types/node": "^22.0.0",
+    "dotenv": "^16.5.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vue": "^3.5.0",
+    "vue-router": "^4.5.0"
+  },
+  "peerDependencies": {
+    "vue": ">=3.3.0",
+    "vue-router": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vue": {
+      "optional": true
+    },
+    "vue-router": {
+      "optional": true
+    }
+  }
+}