@indiebob/tracker 0.2.4 → 0.4.1

package/dist/server.d.mts

@@ -4,13 +4,13 @@
 interface TrackerConfig {
     /** Your SDK project ID from the IndieBob dashboard. Format: 'proj_...' */
     projectId: string;
-    /** Ingestion endpoint URL. Default: 'https://indiebob.com/api/collect' */
+    /** Ingestion endpoint URL. Default: 'https://www.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 */
+    /** Honor Global Privacy Control signal (legally binding under CCPA in California). Default: true */
     respectGpc?: boolean;
     /**
      * Auto-detect user intent from URL patterns and identify() calls.
@@ -42,8 +42,31 @@ interface TrackerConfig {
         formSubmit?: boolean;
         /** Track clicks on outbound links. Default: true */
         outboundClicks?: boolean;
+        /** Track clicks on links to files (pdf, zip, dmg, …) as `file_download`. Default: true */
+        fileDownloads?: boolean;
     };
+    /**
+     * Treat the URL hash as part of the page path (for `/#/route` routers):
+     * a hash-only change becomes a pageview and the hash is reported in the
+     * path. Default: false (a hash-only change is not a new page).
+     */
+    hashMode?: boolean;
+    /**
+     * What the tracker keeps in the visitor's browser.
+     *
+     * - `'none'` (default): nothing. No id, no stored UTM or referrer, no offline
+     *   queue. IndieBob counts the visitor on its server from a hash of a daily
+     *   salt, the site, the IP address and the user agent; the salt is deleted
+     *   after a day and the IP is never stored. No consent needed.
+     * - `'local'`: a random visitor id, first-touch UTM and referrer in
+     *   localStorage, so a visitor is recognised across days. Storing an id on
+     *   the visitor's device needs their consent in the EU (ePrivacy Art. 5(3)):
+     *   switch to it from your consent banner with `bob.setPersistence('local')`.
+     */
+    persistence?: Persistence;
 }
+/** Where the tracker may store anything: nowhere, or localStorage. */
+type Persistence = 'none' | 'local';
 
 /**
  * Server-side tracker for Node.js environments.

package/dist/server.d.ts

@@ -4,13 +4,13 @@
 interface TrackerConfig {
     /** Your SDK project ID from the IndieBob dashboard. Format: 'proj_...' */
     projectId: string;
-    /** Ingestion endpoint URL. Default: 'https://indiebob.com/api/collect' */
+    /** Ingestion endpoint URL. Default: 'https://www.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 */
+    /** Honor Global Privacy Control signal (legally binding under CCPA in California). Default: true */
     respectGpc?: boolean;
     /**
      * Auto-detect user intent from URL patterns and identify() calls.
@@ -42,8 +42,31 @@ interface TrackerConfig {
         formSubmit?: boolean;
         /** Track clicks on outbound links. Default: true */
         outboundClicks?: boolean;
+        /** Track clicks on links to files (pdf, zip, dmg, …) as `file_download`. Default: true */
+        fileDownloads?: boolean;
     };
+    /**
+     * Treat the URL hash as part of the page path (for `/#/route` routers):
+     * a hash-only change becomes a pageview and the hash is reported in the
+     * path. Default: false (a hash-only change is not a new page).
+     */
+    hashMode?: boolean;
+    /**
+     * What the tracker keeps in the visitor's browser.
+     *
+     * - `'none'` (default): nothing. No id, no stored UTM or referrer, no offline
+     *   queue. IndieBob counts the visitor on its server from a hash of a daily
+     *   salt, the site, the IP address and the user agent; the salt is deleted
+     *   after a day and the IP is never stored. No consent needed.
+     * - `'local'`: a random visitor id, first-touch UTM and referrer in
+     *   localStorage, so a visitor is recognised across days. Storing an id on
+     *   the visitor's device needs their consent in the EU (ePrivacy Art. 5(3)):
+     *   switch to it from your consent banner with `bob.setPersistence('local')`.
+     */
+    persistence?: Persistence;
 }
+/** Where the tracker may store anything: nowhere, or localStorage. */
+type Persistence = 'none' | 'local';
 
 /**
  * Server-side tracker for Node.js environments.

package/dist/server.js

@@ -2,28 +2,38 @@
 
 // src/core/config.ts
 var DEFAULT_ENDPOINT = "https://www.indiebob.com/api/collect";
+var OPTIONS = "projectId endpoint debug respectDnt respectGpc autoDetect hashMode persistence";
+var AUTO_OPTIONS = "signupPaths loginPaths pricingPaths checkoutPaths successPaths onboardingPaths contactPaths dataAttributes formSubmit outboundClicks fileDownloads";
+function warnUnknown(obj, known, where) {
+  for (const k of Object.keys(obj)) {
+    if (!known.split(" ").includes(k)) console.warn(`[IndieBob] Unknown option ${where}"${k}" ignored`);
+  }
+}
 function resolveConfig(input) {
   if (!input.projectId || !input.projectId.startsWith("proj_")) {
     throw new Error(
       `[IndieBob] Invalid projectId "${input.projectId}". Must start with "proj_".`
     );
   }
+  warnUnknown(input, OPTIONS, "");
+  if (typeof input.autoDetect === "object") warnUnknown(input.autoDetect, AUTO_OPTIONS, "autoDetect.");
+  if (input.persistence !== void 0 && input.persistence !== "local" && input.persistence !== "none") {
+    console.warn(`[IndieBob] persistence "${String(input.persistence)}" is not 'none' or 'local'; using 'none'`);
+  }
   return {
     projectId: input.projectId,
     endpoint: input.endpoint ?? DEFAULT_ENDPOINT,
     debug: input.debug ?? false,
     respectDnt: input.respectDnt ?? true,
     respectGpc: input.respectGpc ?? true,
-    autoDetect: input.autoDetect ?? true
+    autoDetect: input.autoDetect ?? true,
+    hashMode: input.hashMode ?? false,
+    persistence: input.persistence === "local" ? "local" : "none"
   };
 }
 
 // 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 {
@@ -36,7 +46,7 @@ async function sendBatchServer(payload, config) {
       if (res.status >= 400 && res.status < 500) return false;
     } catch {
     }
-    if (attempt < MAX_RETRIES - 1) await sleep(RETRY_DELAYS[attempt]);
+    if (attempt < MAX_RETRIES - 1) await new Promise((resolve) => setTimeout(resolve, 1e3 << attempt));
   }
   return false;
 }
@@ -69,6 +79,7 @@ var IndieBobServer = class _IndieBobServer {
   buildEvent(type, extras) {
     return {
       v: 1,
+      id: generateId(),
       projectId: this.config.projectId,
       type,
       anonymousId: `server_${generateId()}`,
@@ -80,7 +91,7 @@ var IndieBobServer = class _IndieBobServer {
         device: { width: 0, height: 0, type: "desktop" },
         locale: "en",
         timezone: "UTC",
-        sdkVersion: "0.2.4" 
+        sdkVersion: "0.4.1" 
       },
       event: extras.event,
       properties: extras.properties,

package/dist/server.mjs

@@ -1,27 +1,37 @@
 // src/core/config.ts
 var DEFAULT_ENDPOINT = "https://www.indiebob.com/api/collect";
+var OPTIONS = "projectId endpoint debug respectDnt respectGpc autoDetect hashMode persistence";
+var AUTO_OPTIONS = "signupPaths loginPaths pricingPaths checkoutPaths successPaths onboardingPaths contactPaths dataAttributes formSubmit outboundClicks fileDownloads";
+function warnUnknown(obj, known, where) {
+  for (const k of Object.keys(obj)) {
+    if (!known.split(" ").includes(k)) console.warn(`[IndieBob] Unknown option ${where}"${k}" ignored`);
+  }
+}
 function resolveConfig(input) {
   if (!input.projectId || !input.projectId.startsWith("proj_")) {
     throw new Error(
       `[IndieBob] Invalid projectId "${input.projectId}". Must start with "proj_".`
     );
   }
+  warnUnknown(input, OPTIONS, "");
+  if (typeof input.autoDetect === "object") warnUnknown(input.autoDetect, AUTO_OPTIONS, "autoDetect.");
+  if (input.persistence !== void 0 && input.persistence !== "local" && input.persistence !== "none") {
+    console.warn(`[IndieBob] persistence "${String(input.persistence)}" is not 'none' or 'local'; using 'none'`);
+  }
   return {
     projectId: input.projectId,
     endpoint: input.endpoint ?? DEFAULT_ENDPOINT,
     debug: input.debug ?? false,
     respectDnt: input.respectDnt ?? true,
     respectGpc: input.respectGpc ?? true,
-    autoDetect: input.autoDetect ?? true
+    autoDetect: input.autoDetect ?? true,
+    hashMode: input.hashMode ?? false,
+    persistence: input.persistence === "local" ? "local" : "none"
   };
 }
 
 // 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 {
@@ -34,7 +44,7 @@ async function sendBatchServer(payload, config) {
       if (res.status >= 400 && res.status < 500) return false;
     } catch {
     }
-    if (attempt < MAX_RETRIES - 1) await sleep(RETRY_DELAYS[attempt]);
+    if (attempt < MAX_RETRIES - 1) await new Promise((resolve) => setTimeout(resolve, 1e3 << attempt));
   }
   return false;
 }
@@ -67,6 +77,7 @@ var IndieBobServer = class _IndieBobServer {
   buildEvent(type, extras) {
     return {
       v: 1,
+      id: generateId(),
       projectId: this.config.projectId,
       type,
       anonymousId: `server_${generateId()}`,
@@ -78,7 +89,7 @@ var IndieBobServer = class _IndieBobServer {
         device: { width: 0, height: 0, type: "desktop" },
         locale: "en",
         timezone: "UTC",
-        sdkVersion: "0.2.4" 
+        sdkVersion: "0.4.1" 
       },
       event: extras.event,
       properties: extras.properties,