pishoniq-tracker 0.0.0-stage → 2.0.1

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [2.0.0] - 2026-09-05
+
+### Added
+
+- Published browser SDK on npm as `pishoniq`, with a CDN-ready `dist/browser.global.js` bundle at jsDelivr and unpkg.
+- Configurable auto-capture (`autoCapture`) to enable/disable clicks, page views, scroll depth, and sessions individually.
+- Configurable event sampling (`sampleRate`).
+- Configurable network behavior (`flushIntervalMs`, `maxBatchSize`, `maxQueueSize`).
+- In-memory session cache with throttled `localStorage` writes.
+- Queue bound that drops oldest events past `maxQueueSize` during outages.
+
+### Changed
+
+- Unload/visibility flushes now use `fetch(..., { keepalive: true })` with the `Authorization` header instead of `navigator.sendBeacon`, so the API key no longer travels in the request body.
+- Session and network state are cleaned up on `_reset()`.
+- `identify`, `session_start`, and `session_end` events are exempt from sampling.
+
+### Fixed
+
+- `flush()` no longer hardcodes the session storage key.
+- React provider no longer reads stale init options on re-render.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PishonIQ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,453 @@
-# Temporary Holding Version
+# pishoniq
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Browser analytics SDK for PishonIQ. Track user events, sessions, and behavior in your web applications.
+
+## Features
+
+- **Auto-capture**: Page views, clicks, scroll depth, sessions
+- **Event batching**: Efficient network usage with 2-second flush intervals
+- **Retry logic**: Exponential backoff for failed requests
+- **React support**: Provider component with hooks
+- **TypeScript**: Full type definitions included
+- **SPA support**: History API patching for React Router
+
+---
+
+## Installation
+
+### npm
+
+```bash
+npm install pishoniq-tracker
+```
+
+Or using yarn:
+
+```bash
+yarn add pishoniq
+```
+
+### CDN script tag
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/pishoniq-tracker@2.0.0/dist/browser.global.js"></script>
+```
+
+The script exposes `window.PishonIQ`. Use `https://unpkg.com/pishoniq-tracker@2.0.0/dist/browser.global.js` as an alternative CDN.
+
+---
+
+## Quick Start
+
+### Option 1: Vanilla JavaScript (Any Framework)
+
+```javascript
+import PishonIQ from 'pishoniq-tracker';
+
+// Initialize with your API key and backend host
+PishonIQ.init({
+  apiKey: 'pk_live_xxxxxxxxxxxx',
+  host: 'https://your-pishoniq-backend.com'
+});
+
+// Track custom events
+PishonIQ.track('button_clicked', { button: 'signup', location: 'hero' });
+PishonIQ.track('purchase_completed', { amount: 99.99, currency: 'USD' });
+
+// Identify users
+PishonIQ.identify('user_123', { email: 'user@example.com', plan: 'pro' });
+
+// Track page views manually
+PishonIQ.page('Checkout');
+```
+
+### Option 2: Script Tag (No Build Step)
+
+```html
+<!-- Add before </body> -->
+<script src="https://cdn.jsdelivr.net/npm/pishoniq-tracker@2.0.0/dist/browser.global.js"></script>
+<script>
+  window.PishonIQ.init({
+    apiKey: 'pk_live_xxxxxxxxxxxx',
+    host: 'https://your-pishoniq-backend.com'
+  });
+
+  window.PishonIQ.track('sdk_installed');
+</script>
+```
+
+If you point the script at `defer`, initialize inside `DOMContentLoaded` instead of immediately:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/pishoniq-tracker@2.0.0/dist/browser.global.js" defer></script>
+<script>
+  window.addEventListener('DOMContentLoaded', function () {
+    window.PishonIQ.init({ apiKey: 'pk_live_xxxxxxxxxxxx', host: 'https://your-pishoniq-backend.com' });
+  });
+</script>
+```
+
+Self-hosted fallback: `https://your-pishoniq-backend.com/sdk/pishoniq.sdk.js`.
+
+---
+
+## React Setup (Recommended)
+
+### Step 1: Wrap Your App with Provider
+
+```tsx
+// main.jsx or App.jsx
+import { BrowserRouter } from 'react-router-dom';
+import { PishonIQProvider } from 'pishoniq-tracker/react';
+import App from './App';
+
+function Root() {
+  return (
+    <PishonIQProvider
+      apiKey="pk_live_xxxxxxxxxxxx"
+      host="https://your-pishoniq-backend.com"
+    >
+      <BrowserRouter>
+        <App />
+      </BrowserRouter>
+    </PishonIQProvider>
+  );
+}
+
+export default Root;
+```
+
+### Step 2: Track Events in Components
+
+```tsx
+// components/SignupButton.jsx
+import { usePishonIQ } from 'pishoniq-tracker/react';
+
+function SignupButton() {
+  const { track } = usePishonIQ();
+
+  const handleClick = () => {
+    track('signup_clicked', { source: 'homepage' });
+    // ... your signup logic
+  };
+
+  return <button onClick={handleClick}>Sign Up</button>;
+}
+```
+
+### Step 3: Identify Users After Login
+
+```tsx
+// contexts/AuthContext.jsx
+import { useEffect } from 'react';
+import { usePishonIQ } from 'pishoniq-tracker/react';
+import { useAuth } from './useAuth';
+
+function AuthProvider({ children }) {
+  const { user } = useAuth();
+  const { identify } = usePishonIQ();
+
+  useEffect(() => {
+    if (user) {
+      identify(user.id, {
+        email: user.email,
+        name: user.name,
+        plan: user.plan,
+        createdAt: user.createdAt
+      });
+    }
+  }, [user, identify]);
+
+  return <>{children}</>;
+}
+```
+
+### Step 4: Track Page Views (React Router v6)
+
+The `usePishonIQ` hook automatically tracks page views on route changes:
+
+```tsx
+// Already automatic with React Router v6
+// No additional code needed!
+
+function App() {
+  return (
+    <Routes>
+      <Route path="/" element={<Home />} />
+      <Route path="/products/:id" element={<ProductPage />} />
+      <Route path="/checkout" element={<Checkout />} />
+    </Routes>
+  );
+}
+```
+
+---
+
+## API Reference
+
+### PishonIQ.init(options)
+
+Initialize the SDK. Must be called before any other methods.
+
+```typescript
+PishonIQ.init({
+  apiKey: string;      // Required: Your SDK API key from PishonIQ dashboard
+  host: string;       // Required: Your PishonIQ backend URL
+  debug?: boolean;    // Optional: Enable debug logging (default: false)
+});
+```
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `apiKey` | string | Yes | Your project SDK key (starts with `pk_live_` or `pk_test_`) |
+| `host` | string | Yes | Full URL of your PishonIQ backend (e.g., `https://analytics.example.com`) |
+| `debug` | boolean | No | Log events and network activity to console |
+
+---
+
+### PishonIQ.track(event, properties?)
+
+Track a custom event.
+
+```typescript
+PishonIQ.track('purchase_completed', {
+  amount: 149.99,
+  currency: 'USD',
+  items: 3,
+  discount: true
+});
+```
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `event` | string | Yes | Event name (e.g., `purchase_completed`, `form_submitted`) |
+| `properties` | object | No | Custom properties to attach to the event |
+
+**Best Practices for Event Names:**
+- Use lowercase with underscores: `signup_clicked` not `SignupClicked`
+- Be specific: `checkout_step_2` not `step`
+- Use past tense for completed actions: `purchase_completed` not `purchase`
+
+---
+
+### PishonIQ.identify(userId, traits?)
+
+Identify a user and attach traits.
+
+```typescript
+PishonIQ.identify('user_12345', {
+  email: 'john@example.com',
+  name: 'John Doe',
+  plan: 'pro',
+  company: 'Acme Inc',
+  createdAt: '2024-01-15'
+});
+```
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `userId` | string | Yes | Unique identifier for the user |
+| `traits` | object | No | User properties (email, name, plan, etc.) |
+
+---
+
+### PishonIQ.page(pageName?)
+
+Track a page view manually.
+
+```typescript
+// Track a product page view
+PishonIQ.page('Product Page');
+
+// Track a virtual page
+PishonIQ.page('/checkout/step-2');
+```
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `pageName` | string | No | Page name or path (defaults to `document.title`) |
+
+> **Note:** In React with `PishonIQProvider`, page views are tracked automatically on route changes. Call this method only for custom page tracking.
+
+---
+
+## Auto-Captured Events
+
+The SDK automatically captures these events:
+
+| Event | Trigger | Properties |
+|-------|---------|------------|
+| `page_view` | Page load, route change | `pageName`, `pathname`, `search`, `referrer`, `source` |
+| `click` | Button/link clicks | `tag`, `text`, `href`, `pishon` |
+| `scroll_depth` | Scroll milestones | `depth`, `percent` |
+| `session_start` | New session begins | `referrer` |
+| `session_end` | Tab close / page hide | `durationMs` |
+
+### Tagging Elements
+
+Add `data-pishon` attribute to track specific elements:
+
+```html
+<!-- Track this button click -->
+<button data-pishon="signup-hero-btn">Get Started</button>
+
+<!-- Track links -->
+<a href="/pricing" data-pishon="nav-pricing-link">Pricing</a>
+
+<!-- Track any element -->
+<div data-pishon="feature-card-pricing">...</div>
+```
+
+---
+
+## React Hooks
+
+### usePishonIQ()
+
+Access the PishonIQ instance and auto-tracking functions.
+
+```tsx
+import { usePishonIQ } from 'pishoniq-tracker/react';
+
+function MyComponent() {
+  const { track, identify, page } = usePishonIQ();
+
+  return (
+    <button onClick={() => track('my_event', { foo: 'bar' })}>
+      Track Event
+    </button>
+  );
+}
+```
+
+---
+
+## Environment Setup
+
+### Development vs Production Keys
+
+Use separate API keys for each environment:
+
+```tsx
+const config = {
+  development: {
+    apiKey: 'pk_test_xxxxxxxxxxxx',
+    host: 'http://localhost:3033'
+  },
+  production: {
+    apiKey: 'pk_live_xxxxxxxxxxxx',
+    host: 'https://your-pishoniq-backend.com'
+  }
+};
+
+const env = process.env.NODE_ENV === 'production' ? config.production : config.development;
+
+<PishonIQProvider apiKey={env.apiKey} host={env.host}>
+  <App />
+</PishonIQProvider>
+```
+
+---
+
+## Local Development Setup
+
+### Step 1: Build the SDK
+
+```bash
+cd pishoniq-sdk
+npm install
+npm run build
+```
+
+### Step 2: Link to Your React Project
+
+```bash
+cd ../your-react-project
+npm install ../pishoniq-sdk
+```
+
+### Step 3: Start Your Backend
+
+Make sure your PishonIQ backend is running:
+
+```bash
+cd pishoniq-backend
+npm install
+npm run dev  # or: node app.js
+```
+
+### Step 4: Get Your SDK Key
+
+1. Go to your PishonIQ dashboard
+2. Navigate to Settings → Application
+3. Select your environment
+4. Copy the SDK key (starts with `pk_live_` or `pk_test_`)
+
+---
+
+## Troubleshooting
+
+### Events Not Appearing
+
+1. **Check API key**: Make sure it matches exactly (including `pk_live_` or `pk_test_` prefix)
+2. **Check backend URL**: Ensure `host` doesn't have trailing slash
+3. **Enable debug mode**: `PishonIQ.init({ ..., debug: true })`
+4. **Check browser console**: Look for error messages
+5. **Verify CORS**: Ensure your backend allows requests from your domain
+
+### Double Page Views in React
+
+The `usePishonIQ` hook automatically tracks page views. If you're also calling `PishonIQ.page()` manually, you'll see duplicate events. Remove the manual calls.
+
+### "Invalid API Key" Error
+
+1. Verify the key exists in your PishonIQ dashboard
+2. Check the key is active (not revoked)
+3. Ensure the key matches the environment (test vs live)
+
+### CORS Errors
+
+The PishonIQ backend must have CORS configured to accept requests from your domain. Add your domain to the allowed origins in backend environment variables.
+
+---
+
+## Payload Format
+
+Events are batched and sent as:
+
+```json
+POST /api/events
+Authorization: Bearer pk_live_xxxxx
+Content-Type: application/json
+
+{
+  "events": [
+    {
+      "sessionId": "550e8400-e29b-41d4-a716-446655440000",
+      "userId": "user_123",
+      "event": "page_view",
+      "properties": {
+        "url": "https://example.com/products",
+        "title": "Products"
+      },
+      "timestamp": 1710000000000,
+      "url": "https://example.com/products",
+      "userAgent": "Mozilla/5.0..."
+    }
+  ]
+}
+```
+
+---
+
+## Session Management
+
+- Sessions last 30 minutes of inactivity
+- Sessions are stored in `localStorage` (`pishoniq_session_id`)
+- User ID and traits persist across sessions
+
+---
+
+## License
+
+MIT

package/dist/browser.global.js

@@ -0,0 +1 @@
+var PishonIQBundle=(function(exports){'use strict';var y="pishoniq_session_id",B="pishoniq_session_last_active",J="pishoniq_session_started";var d=null,a=0,g=0,A=0;function m(){return typeof window<"u"&&typeof localStorage<"u"}function j(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return (e==="x"?t:t&3|8).toString(16)})}function G(){if(!m())return 0;if(a)return a;let e=localStorage.getItem(B);return a=e?Number(e):0,a}function Z(e,t){if(!m())return;let n=Date.now();d=e,g=t,a=n,A=n;try{localStorage.setItem(y,e),localStorage.setItem(J,String(t)),localStorage.setItem(B,String(n));}catch{}}function w(){if(!m())return "";let e=Date.now();if(d&&a&&e-a<18e5)return d;let t=d??localStorage.getItem(y),n=G();if(t&&n&&e-n<18e5)return d=t,t;let r=j();return Z(r,e),r}function u(){if(!m())return;let e=Date.now();if(a=e,!(e-A<1e3)){A=e;try{localStorage.setItem(B,String(e));}catch{}}}function ee(){let e=j();return Z(e,Date.now()),{sessionId:e,isNew:true}}function R(){if(!m())return {sessionId:"",isNew:false};let e=Date.now(),t=d??localStorage.getItem(y),n=G();if(t&&n&&e-n<18e5)return d=t,u(),{sessionId:t,isNew:false};let{sessionId:r}=ee();return {sessionId:r,isNew:true}}function Te(){if(!m())return Date.now();if(g)return g;let e=localStorage.getItem(J);return g=e?Number(e):Date.now(),g}function te(){return Date.now()-Te()}function ne(){d=null,a=0,g=0,A=0;}var Ae=2e3,Re=100,Pe=1e3,q=3,Ne=3,Ce=[1e3,2e3,4e3],s=null,i=[],E=null,P=0,p=false,N=false,K=0,z=null,C=false;function I(...e){p&&console.log("[PishonIQ]",...e);}function f(...e){p&&console.warn("[PishonIQ]",...e);}function se(e){p=e;}function D(){return typeof window<"u"}function De(){return D()?(z===null&&(z=navigator.userAgent),{url:window.location.href,userAgent:z}):{url:"",userAgent:""}}function ie(){return s?.flushIntervalMs??Ae}function oe(){return s?.maxBatchSize??Re}function re(){return s?.maxQueueSize??Pe}function ae(){!D()||E||(E=setInterval(()=>{S(false);},ie()));}function H(){E&&(clearInterval(E),E=null);}function ue(){typeof document>"u"||(document.visibilityState==="hidden"?(S(true),H()):ae());}function le(){S(true);}function ce(e){s=e,D()&&(H(),ae(),N||(N=true,window.addEventListener("beforeunload",le),document.addEventListener("visibilitychange",ue)),I(`Network ready | endpoint: ${e.host}/api/events | flush every ${ie()}ms`));}function de(){H(),D()&&N&&(N=false,window.removeEventListener("beforeunload",le),document.removeEventListener("visibilitychange",ue)),s=null,i=[],P=0,K=0,C=false;}function l(e,t){if(!s){f("enqueueEvent called before init \u2014 event dropped:",e);return}let n=s.sampleRate??1;if(!(e==="identify"||e==="session_start"||e==="session_end")&&n<1&&Math.random()>n)return;u();let o={sessionId:w(),userId:s.getUserId(),event:e,properties:t,timestamp:Date.now(),schemaVersion:1,...De()};if(i.push(o),o.sessionId||(C=true),i.length>re()){let h=i.length-re();i.splice(0,h),K+=h,p&&f(`Queue full \u2014 dropped ${h} oldest event(s) (${K} total)`);}p&&I(`Event queued: "${e}" | queue size: ${i.length}`,t??""),i.length>=oe()&&(p&&I(`Queue reached max batch size (${oe()}) \u2014 flushing immediately`),S(false));}function x(e){if(C){for(let t of i)t.sessionId||(t.sessionId=e);C=false;}}function Le(e,t,n){let r=new Array(e.length);for(let o=0;o<e.length;o++){let h=e[o];r[o]={...h,sessionId:h.sessionId||t,userId:h.userId??n};}return r}function Me(){return `${(s?.host??"").replace(/\/$/,"")}/api/events`}async function fe(e,t){if(!s||e.length===0)return {ok:true,retryable:false};let n=Me(),r={events:e};try{I(`Flushing ${e.length} event(s) \u2192 ${n}`);let o=await fetch(n,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${s.apiKey}`},body:JSON.stringify(r),keepalive:t});return o.ok?(I(`\u2713 Sent ${e.length} event(s) successfully`),{ok:!0,retryable:!1,status:o.status}):(f(`\u2717 Server rejected events | HTTP ${o.status} | url: ${n}`),o.status===401?(f("\u2717 Invalid apiKey \u2014 events will not be retried. Check the apiKey passed to PishonIQ.init()."),{ok:!1,retryable:!1,status:o.status}):o.status===400?{ok:!1,retryable:!1,status:o.status}:{ok:!1,retryable:!0,status:o.status})}catch(o){return f(`\u2717 Network error \u2014 backend unreachable at ${n}`,o instanceof Error?o.message:o),{ok:false,retryable:true}}}function he(e,t){if(t>=q){f(`Gave up after ${q} retries \u2014 ${e.length} event(s) lost`);return}if(P>=Ne){f(`Too many pending retries \u2014 dropping batch of ${e.length} event(s)`);return}let n=Ce[t]??4e3;f(`Retrying in ${n}ms (attempt ${t+1}/${q})`),P+=1,setTimeout(()=>{P-=1,(async()=>{let r=await fe(e,false);!r.ok&&r.retryable&&he(e,t+1);})();},n);}function S(e=false){if(!s||i.length===0)return;let t=i;i=[];let n=t[0]?.sessionId||(typeof window<"u"?localStorage.getItem(y)??"":"");p&&I(`Flushing ${t.length} event(s) | sessionId: ${n} | useBeacon: ${e}`);let r=Le(t,n,s?.getUserId());(async()=>{let o=await fe(r,e);!o.ok&&!e&&o.retryable&&he(r,0);})();}var $e=[25,50,75,100],L=false,pe=false,ge="",me=false,we=false,M=false,c={clicks:true,pageViews:true,scrollDepth:true,sessions:true},F=new Set;function U(){return typeof window<"u"&&typeof document<"u"}function Ue(e){let t=e.target;return t instanceof Element?t.closest("[data-pishon], button, a, input[type='button'], input[type='submit']"):null}function Oe(e){let t=(e.textContent??"").trim().slice(0,200),n={tag:e.tagName,text:t};e instanceof HTMLAnchorElement&&e.href&&(n.href=e.href);let r=e.getAttribute("data-pishon");return r&&(n.pishon=r),n}function W(e,t="auto"){if(!U()||!c.pageViews)return;let n=window.location.href;n===ge&&me||(ge=n,me=true,F.clear(),l("page_view",{pageName:e??document.title,pathname:window.location.pathname,search:window.location.search,referrer:document.referrer||void 0,source:t}));}function V(){we||W(void 0,"history");}function Qe(){if(!U()||pe)return;pe=true;let e=history.pushState.bind(history),t=history.replaceState.bind(history);history.pushState=function(...n){e(...n),V();},history.replaceState=function(...n){t(...n),V();},window.addEventListener("popstate",V);}function Ie(e){if(!c.clicks)return;let t=Ue(e);t&&l("click",Oe(t));}function Be(){let e=document.documentElement,t=window.scrollY||e.scrollTop,n=e.scrollHeight-e.clientHeight;return n<=0?100:Math.min(100,Math.round(t/n*100))}var Y=false;function Se(){!c.scrollDepth||Y||(Y=true,requestAnimationFrame(()=>{Y=false;let e=Be();for(let t of $e)e>=t&&!F.has(t)&&(F.add(t),l("scroll_depth",{depth:t,percent:e}));}));}function $(){!c.sessions||M||(M=true,l("session_end",{durationMs:te()}),S(true));}function ve(e){we=e;}function ye(e){if(!U()||L)return;e&&(c={clicks:e.clicks??true,pageViews:e.pageViews??true,scrollDepth:e.scrollDepth??true,sessions:e.sessions??true}),L=true,M=false;let{isNew:t}=R();t&&c.sessions&&l("session_start",{referrer:document.referrer||void 0}),Qe(),W(void 0,"initial"),c.clicks&&document.addEventListener("click",Ie,true),c.scrollDepth&&window.addEventListener("scroll",Se,{passive:true}),c.sessions&&(window.addEventListener("beforeunload",$),window.addEventListener("pagehide",$));}function Ee(){!U()||!L||(L=false,M=false,document.removeEventListener("click",Ie,true),window.removeEventListener("scroll",Se),window.removeEventListener("beforeunload",$),window.removeEventListener("pagehide",$));}function xe(e){W(e,"manual");}function be(){u();}var _e="pishoniq_user_id",ke="pishoniq_user_traits",qe=/^https?:\/\/(localhost|127\.0\.0\.1)(:\d+)?\/?$/i,_=false,b="",O="",Q,k;function v(){return typeof window<"u"}function ze(){if(!v())return;Q=localStorage.getItem(_e)??void 0;let e=localStorage.getItem(ke);if(e)try{k=JSON.parse(e);}catch{k=void 0;}}function Ke(e,t){v()&&(localStorage.setItem(_e,e),t&&localStorage.setItem(ke,JSON.stringify(t)));}function X(){if(!_)throw new Error("[PishonIQ] Call PishonIQ.init() before using the SDK")}var T=class{static isInitialized(){return _}static init(t){if(!t.apiKey)throw new Error("[PishonIQ] apiKey is required");if(!t.host)throw new Error("[PishonIQ] host is required \u2014 pass the URL of your PishonIQ backend");let n=t.sampleRate??1;if(!(n>=0&&n<=1))throw new Error("[PishonIQ] sampleRate must be between 0 and 1");if(_){console.warn("[PishonIQ] init() called more than once; ignoring");return}if(qe.test(t.host)&&console.warn(`[PishonIQ] host "${t.host}" looks like a local address \u2014 make sure to pass your production backend URL in deployed environments`),b=t.apiKey,O=t.host.replace(/\/$/,""),_=true,se(t.debug??false),t.debug){let o=`${b.slice(0,6)}...${b.slice(-4)}`;console.log(`[PishonIQ] Initialized | apiKey: ${o} | host: ${O} | debug: true`);}ze();let{sessionId:r}=R();ce({apiKey:b,host:O,getUserId:()=>Q,flushIntervalMs:t.flushIntervalMs,maxBatchSize:t.maxBatchSize,maxQueueSize:t.maxQueueSize,sampleRate:n}),x(r),v()&&ye(t.autoCapture);}static track(t,n){X(),v()&&(u(),x(w()),l(t,n));}static identify(t,n){X(),v()&&(Q=t,k=n,Ke(t,n),be(),u(),x(w()),l("identify",{userId:t,traits:n??k}));}static page(t){X(),v()&&(u(),x(w()),xe(t));}static _setReactRouterActive(t){ve(t);}static _reset(){_=false,b="",O="",Q=void 0,k=void 0,Ee(),de(),ne();}};typeof window<"u"&&(window.PishonIQ=T);var tt=T;exports.PishonIQ=T;exports.default=tt;Object.defineProperty(exports,'__esModule',{value:true});return exports;})({});