trackhome 0.1.0

package/README.md

@@ -0,0 +1,146 @@
+# trackhome
+
+Tiny browser SDK for [trackhome](https://github.com/exreve/trackhome) — a self-hosted, tags-only event/click tracker.
+
+- **One-line setup**: `init('https://your-trackhome.example.com')` and you're done.
+- **Auto-collects page views** on init and on every SPA route change (React Router, Next.js, Vue Router — all work without extra config).
+- **Tags-only model**: every event is `{type, tags}`. No metadata, no props, no per-visitor IDs on the wire. Use tags for source, campaign, variant, funnel step — uniformly queryable.
+- **Privacy-friendly**: visitor identity is a server-set HttpOnly cookie. JS never touches it. IP/UA are hashed on the server, never stored raw.
+- **Zero dependencies**, ~1 KB gzipped (UMD), works with or without a bundler.
+- **Auto-enriched server-side**: every event also gets `device:*`, `os:*`, `country:*`, `lang:*` tags derived from request headers, so dashboards break down by these for free.
+
+## Install
+
+```bash
+npm install trackhome
+# or: pnpm add trackhome / yarn add trackhome
+```
+
+## Quick start (3 ways)
+
+### 1. Bundler (webpack, Vite, esbuild, …)
+
+```ts
+import { init } from 'trackhome';
+
+// That's it. Fires page_view immediately + on every SPA navigation.
+init('https://trk.example.com');
+```
+
+### 2. Build-less `<script>` tag (CDN from your own trackhome server)
+
+```html
+<script src="https://trk.example.com/t.js"></script>
+<script>
+  trackhome.init('https://trk.example.com');
+</script>
+```
+
+### 3. From a CDN (coming soon — for now, host `/t.js` from your own instance, see option 2)
+
+## Custom events
+
+```ts
+import { track, identify } from 'trackhome';
+
+track('signup_click', ['tier:pro', 'cta:header']);
+track('purchase', ['plan:annual']);
+
+identify('user_42');          // → identify event with user:user_42 tag
+```
+
+## API
+
+### `init(endpointOrConfig)`
+
+```ts
+init('https://trk.example.com')                              // shorthand
+
+init({                                                       // full config
+  endpoint: 'https://trk.example.com',
+  tags: ['app:marketing'],          // persistent tags on every event
+  autoPageView: true,               // default true — see below
+  batchSize: 20,                    // max events per flush
+  flushIntervalMs: 5_000,           // flush cadency in ms
+  disabled: false,                  // kill switch for dev
+})
+```
+
+Idempotent — calling `init()` twice is a no-op.
+
+**`autoPageView` (default: `true`)** — fires a `page_view` event tagged `page:/current/path`:
+1. immediately on init
+2. on `history.pushState` / `replaceState` (catches React Router, Vue Router, Next.js navigation)
+3. on `popstate` (back/forward buttons)
+4. on `hashchange`
+
+So for many sites, the one-liner `init(url)` is all you need — the SDK collects traffic without any manual `track()` calls. Pass `autoPageView: false` if you have your own router hook or want to call `page()` manually.
+
+### `track(type, tags?)`
+
+```ts
+track('signup_click', ['tier:pro']);
+track('page_view');                   // tags optional
+```
+
+`tags` (if provided) are merged with persistent tags (set via `init({tags})` / `setTags` / `addTag`). Duplicates are deduped.
+
+### `page(name?, tags?)`
+
+```ts
+page()                  // → page_view with page:<current-path>
+page('pricing')         // → page_view with page:pricing
+page('/blog/post-1')    // → page_view with page:/blog/post-1
+```
+
+Useful when you want to control page-view timing yourself (e.g. after a custom route transition).
+
+### `identify(userId, tags?)`
+
+```ts
+identify('user_42');
+// → emits { type: 'identify', tags: ['user:user_42', ...persistentTags] }
+```
+
+This is just a tag — it's the same as `track('identify', ['user:user_42'])`. The server doesn't have a separate user table; downstream dashboards can group by `user:*` tags.
+
+### `setTags(tags)` / `addTag(tag)`
+
+Replace / append to the persistent tag set.
+
+```ts
+setTags(['app:marketing', 'variant:b']);
+addTag('flow:onboarding');
+```
+
+### `flush({ useBeacon? })`
+
+Manually flush the pending queue. Auto-flushes on:
+- batch full (default 20 events)
+- timer (default every 5s)
+- `visibilitychange` to hidden
+- `beforeunload`
+- `pagehide`
+
+You only need to call this yourself in tests or for at-exit guarantees.
+
+## Auto-tags (server-side, zero-config)
+
+Every event sent to the trackhome server is enriched with tags derived from the HTTP request — **callers never set these**:
+
+| Tag | Source | Example |
+|---|---|---|
+| `device:mobile` \| `device:desktop` \| `device:tablet` | User-Agent regex | `device:mobile` |
+| `os:android` \| `os:ios` \| `os:macos` \| `os:windows` \| `os:linux` \| `os:chromeos` | User-Agent | `os:ios` |
+| `country:xx` | `cf-ipcountry` / `x-vercel-ip-country` / `x-aws-region` (2-letter ISO) | `country:us` |
+| `lang:xx` | `Accept-Language` (primary prefix) | `lang:en` |
+
+This means a dashboard can break down traffic by device, OS, country, language **for free** — no extra client config. Caller-supplied tags of the same name win on collision.
+
+## Server
+
+This package is just the SDK. The server is at [github.com/exreve/trackhome](https://github.com/exreve/trackhome) — a single Docker image with Fastify + ClickHouse that serves the dashboard, the API, and (optionally) this SDK at `/t.js`. One-command deploy.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,95 @@
+/**
+ * trackhome — tiny browser SDK for the trackhome analytics server.
+ *
+ * Simplest setup (auto-collects page views + clicks):
+ *
+ *   import { init } from 'trackhome';
+ *   init('https://trk.example.com');
+ *
+ * That's it. The SDK fires a page_view immediately, hooks SPA navigation,
+ * and flushes in the background. For custom events:
+ *
+ *   import { track } from 'trackhome';
+ *   track('signup_click', ['tier:pro']);
+ *
+ * Tags-only model: every event is {type, tags}. The visitor is identified
+ * by a server-set HttpOnly cookie (__tv), minted automatically on the first
+ * /ev call. JS never touches the cookie or any visitor id.
+ *
+ * Persistent tags: set via init({tags}) or setTags()/addTag(); they are
+ * auto-merged into every subsequent event. Per-event tags (2nd arg to track)
+ * layer on top.
+ */
+export interface TrackerConfig {
+    /** Base URL of your trackhome instance. Required. */
+    endpoint: string;
+    /** Tags applied to every event from this init. */
+    tags?: string[];
+    /**
+     * Auto-fire `page_view` events on init + on SPA route changes
+     * (popstate / hashchange / pushState / replaceState). Default: true.
+     */
+    autoPageView?: boolean;
+    /** Max events per batch before a forced flush. Default: 20. */
+    batchSize?: number;
+    /** Max time (ms) between flushes. Default: 5000. */
+    flushIntervalMs?: number;
+    /** Disable SDK entirely (e.g. in dev). Default: false. */
+    disabled?: boolean;
+}
+/**
+ * Initialize the SDK. Two accepted shapes:
+ *
+ *   init('https://trk.example.com')                  // shorthand: just the URL
+ *   init({ endpoint: 'https://trk.example.com' })    // full config
+ *
+ * Idempotent — calling init() twice is a no-op.
+ *
+ * With `autoPageView` (default: true), the SDK:
+ *   - fires a `page_view` event immediately for the current URL
+ *   - hooks history.pushState / replaceState + popstate + hashchange
+ *   - fires a `page_view` tagged `path:<current-path>` on every navigation
+ *
+ * That means many sites don't need to call track() at all for basic traffic
+ * analytics — init() alone is enough.
+ */
+export declare function init(userCfgOrUrl: string | TrackerConfig): void;
+/** Replace the persistent tag set. */
+export declare function setTags(tags: string[]): void;
+/** Add a tag to the persistent set. */
+export declare function addTag(tag: string): void;
+/**
+ * Track an event. `tags` (optional) are merged with persistent tags.
+ *
+ *   track('signup_click', ['tier:pro', 'cta:header']);
+ *   track('page_view');                            // tags optional
+ */
+export declare function track(type: string, tags?: string[]): void;
+/**
+ * Shortcut: track('page_view', ['page:'+path]).
+ *
+ * With no args, uses the current path from window.location — useful for
+ * manual SPA hookups when autoPageView isn't right for your router.
+ *
+ *   page()                  // → page_view with page:/current/path
+ *   page('pricing')         // → page_view with page:pricing
+ *   page('/blog/post-1')    // → page_view with page:/blog/post-1
+ */
+export declare function page(name?: string, tags?: string[]): void;
+/** Shortcut: track('identify', ['user:'+userId]). */
+export declare function identify(userId: string, tags?: string[]): void;
+/** Manually flush the pending queue. Mostly useful in tests. */
+export declare function flush(opts?: {
+    useBeacon?: boolean;
+}): Promise<void>;
+/** Expose a global for UMD <script> users. */
+export declare const Tracker: {
+    init: typeof init;
+    track: typeof track;
+    page: typeof page;
+    identify: typeof identify;
+    setTags: typeof setTags;
+    addTag: typeof addTag;
+    flush: typeof flush;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAqBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA4C/D;AAED,sCAAsC;AACtC,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAG5C;AAED,uCAAuC;AACvC,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGxC;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,IAAI,CAG7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,IAAI,CAG7D;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,IAAI,CAElE;AAED,gEAAgE;AAChE,wBAAsB,KAAK,CAAC,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB7E;AAsDD,8CAA8C;AAC9C,eAAO,MAAM,OAAO;;;;;;;;CAA0D,CAAC"}

package/dist/index.js

@@ -0,0 +1,206 @@
+/**
+ * trackhome — tiny browser SDK for the trackhome analytics server.
+ *
+ * Simplest setup (auto-collects page views + clicks):
+ *
+ *   import { init } from 'trackhome';
+ *   init('https://trk.example.com');
+ *
+ * That's it. The SDK fires a page_view immediately, hooks SPA navigation,
+ * and flushes in the background. For custom events:
+ *
+ *   import { track } from 'trackhome';
+ *   track('signup_click', ['tier:pro']);
+ *
+ * Tags-only model: every event is {type, tags}. The visitor is identified
+ * by a server-set HttpOnly cookie (__tv), minted automatically on the first
+ * /ev call. JS never touches the cookie or any visitor id.
+ *
+ * Persistent tags: set via init({tags}) or setTags()/addTag(); they are
+ * auto-merged into every subsequent event. Per-event tags (2nd arg to track)
+ * layer on top.
+ */
+const DEFAULTS = {
+    batchSize: 20,
+    flushIntervalMs: 5000,
+};
+let cfg;
+let queue = [];
+let autoPageViewInstalled = false;
+const isBrowser = typeof window !== 'undefined' && typeof navigator !== 'undefined';
+/**
+ * Initialize the SDK. Two accepted shapes:
+ *
+ *   init('https://trk.example.com')                  // shorthand: just the URL
+ *   init({ endpoint: 'https://trk.example.com' })    // full config
+ *
+ * Idempotent — calling init() twice is a no-op.
+ *
+ * With `autoPageView` (default: true), the SDK:
+ *   - fires a `page_view` event immediately for the current URL
+ *   - hooks history.pushState / replaceState + popstate + hashchange
+ *   - fires a `page_view` tagged `path:<current-path>` on every navigation
+ *
+ * That means many sites don't need to call track() at all for basic traffic
+ * analytics — init() alone is enough.
+ */
+export function init(userCfgOrUrl) {
+    if (!isBrowser)
+        return;
+    if (cfg)
+        return; // idempotent
+    const userCfg = typeof userCfgOrUrl === 'string' ? { endpoint: userCfgOrUrl } : userCfgOrUrl;
+    if (userCfg.disabled)
+        return;
+    if (!userCfg.endpoint) {
+        // eslint-disable-next-line no-console
+        console.warn('[trackhome] init: endpoint is required');
+        return;
+    }
+    const c = {
+        endpoint: userCfg.endpoint.replace(/\/$/, ''),
+        autoPageView: userCfg.autoPageView ?? true,
+        batchSize: userCfg.batchSize ?? DEFAULTS.batchSize,
+        flushIntervalMs: userCfg.flushIntervalMs ?? DEFAULTS.flushIntervalMs,
+        tags: dedupe(userCfg.tags ?? []),
+    };
+    cfg = c;
+    // Background flush timer lives for the page lifetime. setInterval keeps the
+    // reference; we don't need to hold onto it.
+    setInterval(() => {
+        void flush().catch(() => { });
+    }, c.flushIntervalMs);
+    window.addEventListener('visibilitychange', () => {
+        if (document.visibilityState === 'hidden')
+            void flush({ useBeacon: true }).catch(() => { });
+    });
+    window.addEventListener('beforeunload', () => {
+        void flush({ useBeacon: true }).catch(() => { });
+    });
+    window.addEventListener('pagehide', () => {
+        void flush({ useBeacon: true }).catch(() => { });
+    });
+    if (c.autoPageView) {
+        installAutoPageView();
+        // Fire the initial page_view for the entry URL.
+        page();
+    }
+}
+/** Replace the persistent tag set. */
+export function setTags(tags) {
+    if (!cfg)
+        return;
+    cfg.tags = dedupe(tags);
+}
+/** Add a tag to the persistent set. */
+export function addTag(tag) {
+    if (!cfg)
+        return;
+    if (!cfg.tags.includes(tag))
+        cfg.tags = [...cfg.tags, tag];
+}
+/**
+ * Track an event. `tags` (optional) are merged with persistent tags.
+ *
+ *   track('signup_click', ['tier:pro', 'cta:header']);
+ *   track('page_view');                            // tags optional
+ */
+export function track(type, tags = []) {
+    if (!cfg || !type)
+        return;
+    enqueue(type, tags);
+}
+/**
+ * Shortcut: track('page_view', ['page:'+path]).
+ *
+ * With no args, uses the current path from window.location — useful for
+ * manual SPA hookups when autoPageView isn't right for your router.
+ *
+ *   page()                  // → page_view with page:/current/path
+ *   page('pricing')         // → page_view with page:pricing
+ *   page('/blog/post-1')    // → page_view with page:/blog/post-1
+ */
+export function page(name, tags = []) {
+    const path = name ?? (typeof location !== 'undefined' ? location.pathname : '');
+    track('page_view', [path ? `page:${path}` : '', ...tags].filter(Boolean));
+}
+/** Shortcut: track('identify', ['user:'+userId]). */
+export function identify(userId, tags = []) {
+    track('identify', [`user:${userId}`, ...tags]);
+}
+/** Manually flush the pending queue. Mostly useful in tests. */
+export async function flush(opts = {}) {
+    if (!cfg || queue.length === 0)
+        return;
+    const batch = queue.splice(0, queue.length);
+    const payload = JSON.stringify(batch);
+    try {
+        if (opts.useBeacon && navigator.sendBeacon) {
+            const blob = new Blob([payload], { type: 'application/json' });
+            const ok = navigator.sendBeacon(`${cfg.endpoint}/ev`, blob);
+            if (ok)
+                return;
+        }
+        await fetch(`${cfg.endpoint}/ev`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            credentials: 'include',
+            keepalive: true,
+            body: payload,
+        });
+    }
+    catch (err) {
+        queue.unshift(...batch);
+        if (cfg && !opts.useBeacon) {
+            // eslint-disable-next-line no-console
+            console.warn('[trackhome] flush failed', err);
+        }
+    }
+}
+// ============================================================
+// Internal: queue + SPA page_view hook
+// ============================================================
+function enqueue(type, tags) {
+    queue.push({ type, tags: dedupe([...(cfg?.tags ?? []), ...tags]) });
+    if (queue.length >= (cfg?.batchSize ?? DEFAULTS.batchSize)) {
+        void flush().catch(() => { });
+    }
+}
+function dedupe(tags) {
+    return Array.from(new Set(tags.filter((t) => typeof t === 'string' && t.length > 0)));
+}
+/**
+ * Hook SPA navigation so autoPageView fires on pushState/replaceState too.
+ * Most frameworks (React Router, Vue Router, Next.js) use the History API,
+ * so this catches their navigations without framework-specific glue.
+ */
+function installAutoPageView() {
+    if (autoPageViewInstalled || typeof history === 'undefined')
+        return;
+    autoPageViewInstalled = true;
+    let lastPath = typeof location !== 'undefined' ? location.pathname : '';
+    const onRouteChange = () => {
+        if (!cfg?.autoPageView)
+            return;
+        const path = typeof location !== 'undefined' ? location.pathname : '';
+        if (path === lastPath)
+            return;
+        lastPath = path;
+        page();
+    };
+    // Wrap pushState + replaceState so we get a callback after the URL changes.
+    for (const method of ['pushState', 'replaceState']) {
+        const original = history[method];
+        history[method] = function (...args) {
+            const ret = original.apply(this, args);
+            // Defer to let the browser update location before we read it.
+            setTimeout(onRouteChange, 0);
+            return ret;
+        };
+    }
+    window.addEventListener('popstate', onRouteChange);
+    window.addEventListener('hashchange', onRouteChange);
+}
+/** Expose a global for UMD <script> users. */
+export const Tracker = { init, track, page, identify, setTags, addTag, flush };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/t.umd.js

@@ -0,0 +1,2 @@
+(function(a,o){typeof exports=="object"&&typeof module<"u"?o(exports):typeof define=="function"&&define.amd?define(["exports"],o):(a=typeof globalThis<"u"?globalThis:a||self,o(a.Tracker={}))})(this,function(a){"use strict";const o={batchSize:20,flushIntervalMs:5e3};let n,c=[],l=!1;const w=typeof window<"u"&&typeof navigator<"u";function h(e){if(!w||n)return;const t=typeof e=="string"?{endpoint:e}:e;if(t.disabled)return;if(!t.endpoint){console.warn("[trackhome] init: endpoint is required");return}const i={endpoint:t.endpoint.replace(/\/$/,""),autoPageView:t.autoPageView??!0,batchSize:t.batchSize??o.batchSize,flushIntervalMs:t.flushIntervalMs??o.flushIntervalMs,tags:f(t.tags??[])};n=i,setInterval(()=>{s().catch(()=>{})},i.flushIntervalMs),window.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&s({useBeacon:!0}).catch(()=>{})}),window.addEventListener("beforeunload",()=>{s({useBeacon:!0}).catch(()=>{})}),window.addEventListener("pagehide",()=>{s({useBeacon:!0}).catch(()=>{})}),i.autoPageView&&(S(),r())}function p(e){n&&(n.tags=f(e))}function g(e){n&&(n.tags.includes(e)||(n.tags=[...n.tags,e]))}function u(e,t=[]){!n||!e||b(e,t)}function r(e,t=[]){const i=e??(typeof location<"u"?location.pathname:"");u("page_view",[i?`page:${i}`:"",...t].filter(Boolean))}function y(e,t=[]){u("identify",[`user:${e}`,...t])}async function s(e={}){if(!n||c.length===0)return;const t=c.splice(0,c.length),i=JSON.stringify(t);try{if(e.useBeacon&&navigator.sendBeacon){const d=new Blob([i],{type:"application/json"});if(navigator.sendBeacon(`${n.endpoint}/ev`,d))return}await fetch(`${n.endpoint}/ev`,{method:"POST",headers:{"content-type":"application/json"},credentials:"include",keepalive:!0,body:i})}catch(d){c.unshift(...t),n&&!e.useBeacon&&console.warn("[trackhome] flush failed",d)}}function b(e,t){c.push({type:e,tags:f([...(n==null?void 0:n.tags)??[],...t])}),c.length>=((n==null?void 0:n.batchSize)??o.batchSize)&&s().catch(()=>{})}function f(e){return Array.from(new Set(e.filter(t=>typeof t=="string"&&t.length>0)))}function S(){if(l||typeof history>"u")return;l=!0;let e=typeof location<"u"?location.pathname:"";const t=()=>{if(!(n!=null&&n.autoPageView))return;const i=typeof location<"u"?location.pathname:"";i!==e&&(e=i,r())};for(const i of["pushState","replaceState"]){const d=history[i];history[i]=function(...v){const T=d.apply(this,v);return setTimeout(t,0),T}}window.addEventListener("popstate",t),window.addEventListener("hashchange",t)}const m={init:h,track:u,page:r,identify:y,setTags:p,addTag:g,flush:s};a.Tracker=m,a.addTag=g,a.flush=s,a.identify=y,a.init=h,a.page=r,a.setTags=p,a.track=u,Object.defineProperty(a,Symbol.toStringTag,{value:"Module"})});
+//# sourceMappingURL=t.umd.js.map

package/dist/t.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"t.umd.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * trackhome — tiny browser SDK for the trackhome analytics server.\n *\n * Simplest setup (auto-collects page views + clicks):\n *\n *   import { init } from 'trackhome';\n *   init('https://trk.example.com');\n *\n * That's it. The SDK fires a page_view immediately, hooks SPA navigation,\n * and flushes in the background. For custom events:\n *\n *   import { track } from 'trackhome';\n *   track('signup_click', ['tier:pro']);\n *\n * Tags-only model: every event is {type, tags}. The visitor is identified\n * by a server-set HttpOnly cookie (__tv), minted automatically on the first\n * /ev call. JS never touches the cookie or any visitor id.\n *\n * Persistent tags: set via init({tags}) or setTags()/addTag(); they are\n * auto-merged into every subsequent event. Per-event tags (2nd arg to track)\n * layer on top.\n */\n\nexport interface TrackerConfig {\n  /** Base URL of your trackhome instance. Required. */\n  endpoint: string;\n  /** Tags applied to every event from this init. */\n  tags?: string[];\n  /**\n   * Auto-fire `page_view` events on init + on SPA route changes\n   * (popstate / hashchange / pushState / replaceState). Default: true.\n   */\n  autoPageView?: boolean;\n  /** Max events per batch before a forced flush. Default: 20. */\n  batchSize?: number;\n  /** Max time (ms) between flushes. Default: 5000. */\n  flushIntervalMs?: number;\n  /** Disable SDK entirely (e.g. in dev). Default: false. */\n  disabled?: boolean;\n}\n\ninterface PendingEvent {\n  type: string;\n  tags: string[];\n  ts?: string;\n}\n\nconst DEFAULTS = {\n  batchSize: 20,\n  flushIntervalMs: 5_000,\n} as const;\n\nlet cfg:\n  | (Omit<TrackerConfig, 'tags' | 'disabled'> & { tags: string[] })\n  | undefined;\nlet queue: PendingEvent[] = [];\nlet autoPageViewInstalled = false;\n\nconst isBrowser = typeof window !== 'undefined' && typeof navigator !== 'undefined';\n\n/**\n * Initialize the SDK. Two accepted shapes:\n *\n *   init('https://trk.example.com')                  // shorthand: just the URL\n *   init({ endpoint: 'https://trk.example.com' })    // full config\n *\n * Idempotent — calling init() twice is a no-op.\n *\n * With `autoPageView` (default: true), the SDK:\n *   - fires a `page_view` event immediately for the current URL\n *   - hooks history.pushState / replaceState + popstate + hashchange\n *   - fires a `page_view` tagged `path:<current-path>` on every navigation\n *\n * That means many sites don't need to call track() at all for basic traffic\n * analytics — init() alone is enough.\n */\nexport function init(userCfgOrUrl: string | TrackerConfig): void {\n  if (!isBrowser) return;\n  if (cfg) return; // idempotent\n\n  const userCfg: TrackerConfig =\n    typeof userCfgOrUrl === 'string' ? { endpoint: userCfgOrUrl } : userCfgOrUrl;\n\n  if (userCfg.disabled) return;\n  if (!userCfg.endpoint) {\n    // eslint-disable-next-line no-console\n    console.warn('[trackhome] init: endpoint is required');\n    return;\n  }\n\n  const c: Omit<TrackerConfig, 'tags' | 'disabled'> & { tags: string[] } = {\n    endpoint: userCfg.endpoint.replace(/\\/$/, ''),\n    autoPageView: userCfg.autoPageView ?? true,\n    batchSize: userCfg.batchSize ?? DEFAULTS.batchSize,\n    flushIntervalMs: userCfg.flushIntervalMs ?? DEFAULTS.flushIntervalMs,\n    tags: dedupe(userCfg.tags ?? []),\n  };\n  cfg = c;\n\n  // Background flush timer lives for the page lifetime. setInterval keeps the\n  // reference; we don't need to hold onto it.\n  setInterval(() => {\n    void flush().catch(() => {});\n  }, c.flushIntervalMs);\n\n  window.addEventListener('visibilitychange', () => {\n    if (document.visibilityState === 'hidden') void flush({ useBeacon: true }).catch(() => {});\n  });\n  window.addEventListener('beforeunload', () => {\n    void flush({ useBeacon: true }).catch(() => {});\n  });\n  window.addEventListener('pagehide', () => {\n    void flush({ useBeacon: true }).catch(() => {});\n  });\n\n  if (c.autoPageView) {\n    installAutoPageView();\n    // Fire the initial page_view for the entry URL.\n    page();\n  }\n}\n\n/** Replace the persistent tag set. */\nexport function setTags(tags: string[]): void {\n  if (!cfg) return;\n  cfg.tags = dedupe(tags);\n}\n\n/** Add a tag to the persistent set. */\nexport function addTag(tag: string): void {\n  if (!cfg) return;\n  if (!cfg.tags.includes(tag)) cfg.tags = [...cfg.tags, tag];\n}\n\n/**\n * Track an event. `tags` (optional) are merged with persistent tags.\n *\n *   track('signup_click', ['tier:pro', 'cta:header']);\n *   track('page_view');                            // tags optional\n */\nexport function track(type: string, tags: string[] = []): void {\n  if (!cfg || !type) return;\n  enqueue(type, tags);\n}\n\n/**\n * Shortcut: track('page_view', ['page:'+path]).\n *\n * With no args, uses the current path from window.location — useful for\n * manual SPA hookups when autoPageView isn't right for your router.\n *\n *   page()                  // → page_view with page:/current/path\n *   page('pricing')         // → page_view with page:pricing\n *   page('/blog/post-1')    // → page_view with page:/blog/post-1\n */\nexport function page(name?: string, tags: string[] = []): void {\n  const path = name ?? (typeof location !== 'undefined' ? location.pathname : '');\n  track('page_view', [path ? `page:${path}` : '', ...tags].filter(Boolean));\n}\n\n/** Shortcut: track('identify', ['user:'+userId]). */\nexport function identify(userId: string, tags: string[] = []): void {\n  track('identify', [`user:${userId}`, ...tags]);\n}\n\n/** Manually flush the pending queue. Mostly useful in tests. */\nexport async function flush(opts: { useBeacon?: boolean } = {}): Promise<void> {\n  if (!cfg || queue.length === 0) return;\n  const batch = queue.splice(0, queue.length);\n  const payload = JSON.stringify(batch);\n  try {\n    if (opts.useBeacon && navigator.sendBeacon) {\n      const blob = new Blob([payload], { type: 'application/json' });\n      const ok = navigator.sendBeacon(`${cfg.endpoint}/ev`, blob);\n      if (ok) return;\n    }\n    await fetch(`${cfg.endpoint}/ev`, {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      credentials: 'include',\n      keepalive: true,\n      body: payload,\n    });\n  } catch (err) {\n    queue.unshift(...batch);\n    if (cfg && !opts.useBeacon) {\n      // eslint-disable-next-line no-console\n      console.warn('[trackhome] flush failed', err);\n    }\n  }\n}\n\n// ============================================================\n// Internal: queue + SPA page_view hook\n// ============================================================\n\nfunction enqueue(type: string, tags: string[]): void {\n  queue.push({ type, tags: dedupe([...(cfg?.tags ?? []), ...tags]) });\n  if (queue.length >= (cfg?.batchSize ?? DEFAULTS.batchSize)) {\n    void flush().catch(() => {});\n  }\n}\n\nfunction dedupe(tags: string[]): string[] {\n  return Array.from(new Set(tags.filter((t) => typeof t === 'string' && t.length > 0)));\n}\n\n/**\n * Hook SPA navigation so autoPageView fires on pushState/replaceState too.\n * Most frameworks (React Router, Vue Router, Next.js) use the History API,\n * so this catches their navigations without framework-specific glue.\n */\nfunction installAutoPageView(): void {\n  if (autoPageViewInstalled || typeof history === 'undefined') return;\n  autoPageViewInstalled = true;\n\n  let lastPath = typeof location !== 'undefined' ? location.pathname : '';\n\n  const onRouteChange = () => {\n    if (!cfg?.autoPageView) return;\n    const path = typeof location !== 'undefined' ? location.pathname : '';\n    if (path === lastPath) return;\n    lastPath = path;\n    page();\n  };\n\n  // Wrap pushState + replaceState so we get a callback after the URL changes.\n  for (const method of ['pushState', 'replaceState'] as const) {\n    const original = history[method] as (\n      data: unknown,\n      unused: string,\n      url?: string | URL | null,\n    ) => void;\n    history[method] = function (...args: Parameters<typeof original>) {\n      const ret = original.apply(this, args);\n      // Defer to let the browser update location before we read it.\n      setTimeout(onRouteChange, 0);\n      return ret;\n    };\n  }\n  window.addEventListener('popstate', onRouteChange);\n  window.addEventListener('hashchange', onRouteChange);\n}\n\n/** Expose a global for UMD <script> users. */\nexport const Tracker = { init, track, page, identify, setTags, addTag, flush };\n"],"names":["DEFAULTS","cfg","queue","autoPageViewInstalled","isBrowser","init","userCfgOrUrl","userCfg","c","dedupe","flush","installAutoPageView","page","setTags","tags","addTag","tag","track","type","enqueue","name","path","identify","userId","opts","batch","payload","blob","err","lastPath","onRouteChange","method","original","args","ret","Tracker"],"mappings":"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"}

package/dist/umd.d.ts

@@ -0,0 +1,6 @@
+/**
+ * UMD bundle entry for the SDK, exposed as window.Tracker.
+ * Built by Vite (see packages/sdk/vite.config.ts) into dist/t.umd.js.
+ */
+export * from './index.js';
+//# sourceMappingURL=umd.d.ts.map

package/dist/umd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"umd.d.ts","sourceRoot":"","sources":["../src/umd.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,YAAY,CAAC"}

package/dist/umd.js

@@ -0,0 +1,6 @@
+/**
+ * UMD bundle entry for the SDK, exposed as window.Tracker.
+ * Built by Vite (see packages/sdk/vite.config.ts) into dist/t.umd.js.
+ */
+export * from './index.js';
+//# sourceMappingURL=umd.js.map

package/dist/umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"umd.js","sourceRoot":"","sources":["../src/umd.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,YAAY,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "trackhome",
+  "version": "0.1.0",
+  "description": "Tiny browser SDK for trackhome — a self-hosted, tags-only event/click tracker.",
+  "keywords": [
+    "analytics",
+    "tracking",
+    "events",
+    "click-tracking",
+    "self-hosted",
+    "privacy",
+    "typescript"
+  ],
+  "homepage": "https://github.com/exreve/trackhome",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/exreve/trackhome.git",
+    "directory": "packages/sdk"
+  },
+  "license": "MIT",
+  "author": "exreve",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "browser": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/t.umd.js",
+      "default": "./dist/index.js"
+    },
+    "./umd": {
+      "browser": "./dist/t.umd.js",
+      "default": "./dist/t.umd.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json && vite build",
+    "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
+    "lint": "tsc --noEmit -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "prepublishOnly": "pnpm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vite": "^5.3.0"
+  }
+}