@optiqstudio/track 0.1.0 → 0.2.0

package/dist/browser.d.ts

@@ -11,6 +11,16 @@ export interface InitOptions {
     /** The visitor's choice, if the site already knows it. */
     consent?: Consent;
 }
+/** One thing in a basket or an order. */
+export interface Item {
+    id: string;
+    name?: string;
+    category?: string;
+    brand?: string;
+    variant?: string;
+    price?: number;
+    quantity?: number;
+}
 export interface Properties {
     /** A sale's or deposit's amount. */
     value?: number;
@@ -20,7 +30,9 @@ export interface Properties {
     email?: string;
     /** Hashed in the browser before anything is sent (digits only). */
     phone?: string | number;
-    [property: string]: string | number | boolean | undefined;
+    /** What was viewed, put in the basket or bought (view_content, add_to_cart, begin_checkout, purchase). */
+    items?: Item[];
+    [property: string]: string | number | boolean | Item[] | undefined;
 }
 export declare const COLLECTOR = "https://optiq-collect-951694748196.europe-west2.run.app/e";
 /** One tracker on one page. Most sites use the module functions below, which share one. */
@@ -33,6 +45,7 @@ export declare class Tracker {
     private clicks;
     private visit;
     private person;
+    private personKind;
     private queue;
     private timer;
     private lastPath;
@@ -53,6 +66,11 @@ export declare class Tracker {
     consent(state: Consent): void;
     /** A page view (called by itself in auto mode, on load and on every move of a single-page site). */
     page(): void;
+    /**
+     * What a shop's page says by itself: a product looked at (the schema.org Product the page publishes for Google, with
+     * its id, name, category, brand and price) and a search (?q=, ?s=, ?search=, ?query=, ?keyword=). Once per page.
+     */
+    private shopSignals;
     private wire;
 }
 /** Which kind of contact a link begins, or null: tel: is a call, mailto: with an address an email, wa.me with a number WhatsApp. */

package/dist/hash.d.ts

@@ -1,5 +1,15 @@
 /** SHA-256 in hex, by Web Crypto (browsers, Node 20+, Deno, Bun, edge runtimes); null where it is missing. */
 export declare function sha256(s: string): Promise<string | null>;
+/** Which a person hash is of: the ad platforms take emails and phones apart. */
+export type PersonKind = "email" | "phone";
+/** The hash and what it is of, or null. */
+export declare function personOf(p: {
+    email?: unknown;
+    phone?: unknown;
+} | null | undefined): Promise<{
+    hash: string;
+    kind: PersonKind;
+} | null>;
 /** An email (trimmed, lower-case) or a phone (digits only), as a SHA-256: the only way a person is ever sent. */
 export declare function hashPerson(p: {
     email?: unknown;

package/dist/index.cjs

@@ -42,6 +42,18 @@ function sha256(s) {
     () => null
   );
 }
+async function personOf(p) {
+  if (p && typeof p.email === "string" && p.email.indexOf("@") > 0) {
+    const hash = await sha256(p.email.trim().toLowerCase());
+    return hash ? { hash, kind: "email" } : null;
+  }
+  if (p && (typeof p.phone === "string" || typeof p.phone === "number")) {
+    const digits = String(p.phone).replace(/[^0-9]/g, "");
+    const hash = digits.length >= 7 ? await sha256(digits) : null;
+    return hash ? { hash, kind: "phone" } : null;
+  }
+  return null;
+}
 function hashPerson(p) {
   if (p && typeof p.email === "string" && p.email.indexOf("@") > 0) return sha256(p.email.trim().toLowerCase());
   if (p && (typeof p.phone === "string" || typeof p.phone === "number")) {
@@ -131,6 +143,7 @@ var Tracker = class {
       ref: osr && /^[A-Za-z0-9]{4,16}$/.test(osr) ? osr : null
     };
     this.person = get("ph");
+    this.personKind = get("pk") || null;
     if (o.auto !== false) this.wire();
   }
   visitor() {
@@ -186,7 +199,7 @@ var Tracker = class {
   /** Something a visitor did: a standard name (lead, sign_up, purchase, first_deposit, ...) or one of your own. */
   track(name, props = {}) {
     const rest = {};
-    for (const [k, v] of Object.entries(props)) if (!["value", "currency", "email", "phone"].includes(k) && v !== void 0) rest[k] = v;
+    for (const [k, v] of Object.entries(props)) if (!["value", "currency", "email", "phone", "items"].includes(k) && v !== void 0 && !Array.isArray(v)) rest[k] = v;
     const fresh = Date.now();
     this.visit.last = fresh;
     if (this.consentState !== "denied") put("visit", JSON.stringify(this.visit));
@@ -200,7 +213,7 @@ var Tracker = class {
       page_url: window.location.origin + window.location.pathname,
       referrer: document.referrer ? document.referrer.split("?")[0].slice(0, 300) : null,
       utm: this.utm,
-      click_ids: denied ? {} : this.clicks,
+      click_ids: denied ? {} : { ...this.clicks, ...platformCookies() },
       first_ref: this.touch.first ? this.touch.first.ref : null,
       first_ref_at: this.touch.first ? this.touch.first.at : null,
       last_ref: last ? last.ref : null,
@@ -208,24 +221,30 @@ var Tracker = class {
       value: props.value === void 0 ? null : Number(props.value),
       currency: props.currency || null,
       properties: rest,
-      consent: this.consentState
+      consent: this.consentState,
+      ...Array.isArray(props.items) && props.items.length ? { items: props.items.slice(0, 50) } : {}
     };
-    void hashPerson(denied ? null : props).then((h) => {
+    void personOf(denied ? null : props).then((h) => {
       if (h) {
-        this.person = h;
-        put("ph", h);
+        this.person = h.hash;
+        this.personKind = h.kind;
+        put("ph", h.hash);
+        put("pk", h.kind);
       }
       ev.person_hash = denied ? null : this.person;
+      ev.person_kind = denied || !this.person ? null : this.personKind;
       this.queue.push(ev);
       if (!this.timer) this.timer = setTimeout(() => this.flush(), 400);
     });
   }
   /** Who the visitor is, from now on: their email or phone, hashed here. */
   identify(p) {
-    void hashPerson(p).then((h) => {
+    void personOf(p).then((h) => {
       if (h && this.consentState !== "denied") {
-        this.person = h;
-        put("ph", h);
+        this.person = h.hash;
+        this.personKind = h.kind;
+        put("ph", h.hash);
+        put("pk", h.kind);
       }
     });
   }
@@ -234,8 +253,9 @@ var Tracker = class {
     this.consentState = state === "granted" || state === "denied" ? state : "unknown";
     put("consent", this.consentState);
     if (this.consentState === "denied") {
-      for (const k of ["vid", "ph", "clicks", "visit"]) put(k, null);
+      for (const k of ["vid", "ph", "pk", "clicks", "visit"]) put(k, null);
       this.person = null;
+      this.personKind = null;
       this.clicks = {};
     }
   }
@@ -245,6 +265,19 @@ var Tracker = class {
     if (path === this.lastPath) return;
     this.lastPath = path;
     this.track("page_view");
+    if (this.wired) setTimeout(() => this.shopSignals(path), 1200);
+  }
+  /**
+   * What a shop's page says by itself: a product looked at (the schema.org Product the page publishes for Google, with
+   * its id, name, category, brand and price) and a search (?q=, ?s=, ?search=, ?query=, ?keyword=). Once per page.
+   */
+  shopSignals(path) {
+    if (path !== window.location.pathname + window.location.search) return;
+    const q = new URLSearchParams(window.location.search);
+    const query = ["q", "s", "search", "query", "keyword"].map((k) => q.get(k)).find((v) => v && v.trim());
+    if (query) this.track("search", { query: query.trim().slice(0, 200) });
+    const product = pageProduct();
+    if (product) this.track("view_content", { items: [product.item], value: product.item.price, currency: product.currency });
   }
   wire() {
     if (this.wired) return;
@@ -297,6 +330,58 @@ var Tracker = class {
     window.addEventListener("pagehide", () => this.flush());
   }
 };
+function platformCookies() {
+  const out = {};
+  try {
+    for (const part of document.cookie.split(";")) {
+      const [k, ...v] = part.trim().split("=");
+      const value = decodeURIComponent(v.join("=") || "").slice(0, 300);
+      if (!value) continue;
+      if (k === "_fbp") out.fbp = value;
+      else if (k === "_fbc") out.fbc = value;
+      else if (k === "_ttp") out.ttp = value;
+    }
+  } catch {
+  }
+  return out;
+}
+function pageProduct() {
+  const scripts = document.querySelectorAll('script[type="application/ld+json"]');
+  for (const el of Array.from(scripts)) {
+    let data;
+    try {
+      data = JSON.parse(el.textContent || "null");
+    } catch {
+      continue;
+    }
+    const queue = [data];
+    while (queue.length) {
+      const n = queue.shift();
+      if (Array.isArray(n)) {
+        queue.push(...n);
+        continue;
+      }
+      if (!n || typeof n !== "object") continue;
+      const o = n;
+      if (o["@graph"]) queue.push(o["@graph"]);
+      const type = o["@type"];
+      if (type !== "Product" && !(Array.isArray(type) && type.includes("Product"))) continue;
+      const offers = Array.isArray(o.offers) ? o.offers[0] : o.offers;
+      const id = String(o.sku || o.productID || o.gtin13 || o.mpn || o["@id"] || o.url || o.name || "").slice(0, 100);
+      if (!id) continue;
+      const brand = typeof o.brand === "string" ? o.brand : o.brand?.name;
+      const price = Number(offers?.price ?? offers?.lowPrice);
+      const item = { id };
+      if (typeof o.name === "string") item.name = o.name.slice(0, 200);
+      if (typeof o.category === "string") item.category = o.category.slice(0, 120);
+      if (brand) item.brand = String(brand).slice(0, 120);
+      if (Number.isFinite(price)) item.price = price;
+      const currency = typeof offers?.priceCurrency === "string" ? offers.priceCurrency.toUpperCase().slice(0, 3) : void 0;
+      return { item, currency };
+    }
+  }
+  return null;
+}
 function contactChannel(href) {
   if (/^tel:/i.test(href)) return "call";
   if (/^mailto:[^?]/i.test(href)) return "email";

package/dist/index.d.ts

@@ -1,2 +1,2 @@
 export { COLLECTOR, Tracker, consent, contactChannel, flush, hashPerson, identify, init, page, track } from "./browser";
-export type { Consent, InitOptions, Properties } from "./browser";
+export type { Consent, InitOptions, Item, Properties } from "./browser";

package/dist/index.js

@@ -7,6 +7,18 @@ function sha256(s) {
     () => null
   );
 }
+async function personOf(p) {
+  if (p && typeof p.email === "string" && p.email.indexOf("@") > 0) {
+    const hash = await sha256(p.email.trim().toLowerCase());
+    return hash ? { hash, kind: "email" } : null;
+  }
+  if (p && (typeof p.phone === "string" || typeof p.phone === "number")) {
+    const digits = String(p.phone).replace(/[^0-9]/g, "");
+    const hash = digits.length >= 7 ? await sha256(digits) : null;
+    return hash ? { hash, kind: "phone" } : null;
+  }
+  return null;
+}
 function hashPerson(p) {
   if (p && typeof p.email === "string" && p.email.indexOf("@") > 0) return sha256(p.email.trim().toLowerCase());
   if (p && (typeof p.phone === "string" || typeof p.phone === "number")) {
@@ -96,6 +108,7 @@ var Tracker = class {
       ref: osr && /^[A-Za-z0-9]{4,16}$/.test(osr) ? osr : null
     };
     this.person = get("ph");
+    this.personKind = get("pk") || null;
     if (o.auto !== false) this.wire();
   }
   visitor() {
@@ -151,7 +164,7 @@ var Tracker = class {
   /** Something a visitor did: a standard name (lead, sign_up, purchase, first_deposit, ...) or one of your own. */
   track(name, props = {}) {
     const rest = {};
-    for (const [k, v] of Object.entries(props)) if (!["value", "currency", "email", "phone"].includes(k) && v !== void 0) rest[k] = v;
+    for (const [k, v] of Object.entries(props)) if (!["value", "currency", "email", "phone", "items"].includes(k) && v !== void 0 && !Array.isArray(v)) rest[k] = v;
     const fresh = Date.now();
     this.visit.last = fresh;
     if (this.consentState !== "denied") put("visit", JSON.stringify(this.visit));
@@ -165,7 +178,7 @@ var Tracker = class {
       page_url: window.location.origin + window.location.pathname,
       referrer: document.referrer ? document.referrer.split("?")[0].slice(0, 300) : null,
       utm: this.utm,
-      click_ids: denied ? {} : this.clicks,
+      click_ids: denied ? {} : { ...this.clicks, ...platformCookies() },
       first_ref: this.touch.first ? this.touch.first.ref : null,
       first_ref_at: this.touch.first ? this.touch.first.at : null,
       last_ref: last ? last.ref : null,
@@ -173,24 +186,30 @@ var Tracker = class {
       value: props.value === void 0 ? null : Number(props.value),
       currency: props.currency || null,
       properties: rest,
-      consent: this.consentState
+      consent: this.consentState,
+      ...Array.isArray(props.items) && props.items.length ? { items: props.items.slice(0, 50) } : {}
     };
-    void hashPerson(denied ? null : props).then((h) => {
+    void personOf(denied ? null : props).then((h) => {
       if (h) {
-        this.person = h;
-        put("ph", h);
+        this.person = h.hash;
+        this.personKind = h.kind;
+        put("ph", h.hash);
+        put("pk", h.kind);
       }
       ev.person_hash = denied ? null : this.person;
+      ev.person_kind = denied || !this.person ? null : this.personKind;
       this.queue.push(ev);
       if (!this.timer) this.timer = setTimeout(() => this.flush(), 400);
     });
   }
   /** Who the visitor is, from now on: their email or phone, hashed here. */
   identify(p) {
-    void hashPerson(p).then((h) => {
+    void personOf(p).then((h) => {
       if (h && this.consentState !== "denied") {
-        this.person = h;
-        put("ph", h);
+        this.person = h.hash;
+        this.personKind = h.kind;
+        put("ph", h.hash);
+        put("pk", h.kind);
       }
     });
   }
@@ -199,8 +218,9 @@ var Tracker = class {
     this.consentState = state === "granted" || state === "denied" ? state : "unknown";
     put("consent", this.consentState);
     if (this.consentState === "denied") {
-      for (const k of ["vid", "ph", "clicks", "visit"]) put(k, null);
+      for (const k of ["vid", "ph", "pk", "clicks", "visit"]) put(k, null);
       this.person = null;
+      this.personKind = null;
       this.clicks = {};
     }
   }
@@ -210,6 +230,19 @@ var Tracker = class {
     if (path === this.lastPath) return;
     this.lastPath = path;
     this.track("page_view");
+    if (this.wired) setTimeout(() => this.shopSignals(path), 1200);
+  }
+  /**
+   * What a shop's page says by itself: a product looked at (the schema.org Product the page publishes for Google, with
+   * its id, name, category, brand and price) and a search (?q=, ?s=, ?search=, ?query=, ?keyword=). Once per page.
+   */
+  shopSignals(path) {
+    if (path !== window.location.pathname + window.location.search) return;
+    const q = new URLSearchParams(window.location.search);
+    const query = ["q", "s", "search", "query", "keyword"].map((k) => q.get(k)).find((v) => v && v.trim());
+    if (query) this.track("search", { query: query.trim().slice(0, 200) });
+    const product = pageProduct();
+    if (product) this.track("view_content", { items: [product.item], value: product.item.price, currency: product.currency });
   }
   wire() {
     if (this.wired) return;
@@ -262,6 +295,58 @@ var Tracker = class {
     window.addEventListener("pagehide", () => this.flush());
   }
 };
+function platformCookies() {
+  const out = {};
+  try {
+    for (const part of document.cookie.split(";")) {
+      const [k, ...v] = part.trim().split("=");
+      const value = decodeURIComponent(v.join("=") || "").slice(0, 300);
+      if (!value) continue;
+      if (k === "_fbp") out.fbp = value;
+      else if (k === "_fbc") out.fbc = value;
+      else if (k === "_ttp") out.ttp = value;
+    }
+  } catch {
+  }
+  return out;
+}
+function pageProduct() {
+  const scripts = document.querySelectorAll('script[type="application/ld+json"]');
+  for (const el of Array.from(scripts)) {
+    let data;
+    try {
+      data = JSON.parse(el.textContent || "null");
+    } catch {
+      continue;
+    }
+    const queue = [data];
+    while (queue.length) {
+      const n = queue.shift();
+      if (Array.isArray(n)) {
+        queue.push(...n);
+        continue;
+      }
+      if (!n || typeof n !== "object") continue;
+      const o = n;
+      if (o["@graph"]) queue.push(o["@graph"]);
+      const type = o["@type"];
+      if (type !== "Product" && !(Array.isArray(type) && type.includes("Product"))) continue;
+      const offers = Array.isArray(o.offers) ? o.offers[0] : o.offers;
+      const id = String(o.sku || o.productID || o.gtin13 || o.mpn || o["@id"] || o.url || o.name || "").slice(0, 100);
+      if (!id) continue;
+      const brand = typeof o.brand === "string" ? o.brand : o.brand?.name;
+      const price = Number(offers?.price ?? offers?.lowPrice);
+      const item = { id };
+      if (typeof o.name === "string") item.name = o.name.slice(0, 200);
+      if (typeof o.category === "string") item.category = o.category.slice(0, 120);
+      if (brand) item.brand = String(brand).slice(0, 120);
+      if (Number.isFinite(price)) item.price = price;
+      const currency = typeof offers?.priceCurrency === "string" ? offers.priceCurrency.toUpperCase().slice(0, 3) : void 0;
+      return { item, currency };
+    }
+  }
+  return null;
+}
 function contactChannel(href) {
   if (/^tel:/i.test(href)) return "call";
   if (/^mailto:[^?]/i.test(href)) return "email";

package/dist/server.cjs

@@ -34,6 +34,18 @@ function sha256(s) {
     () => null
   );
 }
+async function personOf(p) {
+  if (p && typeof p.email === "string" && p.email.indexOf("@") > 0) {
+    const hash = await sha256(p.email.trim().toLowerCase());
+    return hash ? { hash, kind: "email" } : null;
+  }
+  if (p && (typeof p.phone === "string" || typeof p.phone === "number")) {
+    const digits = String(p.phone).replace(/[^0-9]/g, "");
+    const hash = digits.length >= 7 ? await sha256(digits) : null;
+    return hash ? { hash, kind: "phone" } : null;
+  }
+  return null;
+}
 function hashPerson(p) {
   if (p && typeof p.email === "string" && p.email.indexOf("@") > 0) return sha256(p.email.trim().toLowerCase());
   if (p && (typeof p.phone === "string" || typeof p.phone === "number")) {
@@ -91,14 +103,15 @@ var Optiq = class {
   }
   async prepare(e) {
     const { email, phone, ...rest } = e;
-    const hash = e.person_hash || await hashPerson({ email, phone });
+    const who = e.person_hash ? { hash: e.person_hash, kind: e.person_kind || "email" } : await personOf({ email, phone });
     const iso = (v) => v instanceof Date ? v.toISOString() : v;
     return {
       ...rest,
       event_id: e.event_id || newId(),
       occurred_at: iso(e.occurred_at),
       last_ref_at: iso(e.last_ref_at),
-      person_hash: hash || void 0
+      person_hash: who?.hash || void 0,
+      person_kind: who?.kind || void 0
     };
   }
   /** Sends one event or many (any number: they go 500 at a time). Answers what was kept, repeated or refused. */

package/dist/server.d.ts

@@ -12,6 +12,18 @@ export interface ServerEvent {
     phone?: string | number;
     /** Who, if you already hash: SHA-256 of the trimmed, lower-case email, or of the phone's digits. */
     person_hash?: string;
+    /** What person_hash is of, so the ad platforms match it as an email or a phone. Default "email". */
+    person_kind?: "email" | "phone";
+    /** What was bought: each with its id, and its name, category, price and quantity where known. */
+    items?: {
+        id: string;
+        name?: string;
+        category?: string;
+        brand?: string;
+        variant?: string;
+        price?: number;
+        quantity?: number;
+    }[];
     /** The browser's visitor id, if your site passes it to your server (localStorage optiq_vid). */
     visitor_id?: string;
     value?: number;

package/dist/server.js

@@ -7,6 +7,18 @@ function sha256(s) {
     () => null
   );
 }
+async function personOf(p) {
+  if (p && typeof p.email === "string" && p.email.indexOf("@") > 0) {
+    const hash = await sha256(p.email.trim().toLowerCase());
+    return hash ? { hash, kind: "email" } : null;
+  }
+  if (p && (typeof p.phone === "string" || typeof p.phone === "number")) {
+    const digits = String(p.phone).replace(/[^0-9]/g, "");
+    const hash = digits.length >= 7 ? await sha256(digits) : null;
+    return hash ? { hash, kind: "phone" } : null;
+  }
+  return null;
+}
 function hashPerson(p) {
   if (p && typeof p.email === "string" && p.email.indexOf("@") > 0) return sha256(p.email.trim().toLowerCase());
   if (p && (typeof p.phone === "string" || typeof p.phone === "number")) {
@@ -64,14 +76,15 @@ var Optiq = class {
   }
   async prepare(e) {
     const { email, phone, ...rest } = e;
-    const hash = e.person_hash || await hashPerson({ email, phone });
+    const who = e.person_hash ? { hash: e.person_hash, kind: e.person_kind || "email" } : await personOf({ email, phone });
     const iso = (v) => v instanceof Date ? v.toISOString() : v;
     return {
       ...rest,
       event_id: e.event_id || newId(),
       occurred_at: iso(e.occurred_at),
       last_ref_at: iso(e.last_ref_at),
-      person_hash: hash || void 0
+      person_hash: who?.hash || void 0,
+      person_kind: who?.kind || void 0
     };
   }
   /** Sends one event or many (any number: they go 500 at a time). Answers what was kept, repeated or refused. */

package/dist/t.js

@@ -1,2 +1,2 @@
-/* Optiq Studio Enterprise tracking 0.1.0: <script async src="https://enterprise.optiq.studio/t.js" data-key="pk_..."></script>. Built from @optiqstudio/track (packages/track); docs: https://enterprise.optiq.studio/developers */
-"use strict";(()=>{function k(n){let t=typeof globalThis!="undefined"?globalThis.crypto:void 0;return!t||!t.subtle||typeof TextEncoder=="undefined"?Promise.resolve(null):t.subtle.digest("SHA-256",new TextEncoder().encode(n)).then(e=>Array.from(new Uint8Array(e),r=>r.toString(16).padStart(2,"0")).join(""),()=>null)}function m(n){if(n&&typeof n.email=="string"&&n.email.indexOf("@")>0)return k(n.email.trim().toLowerCase());if(n&&(typeof n.phone=="string"||typeof n.phone=="number")){let t=String(n.phone).replace(/[^0-9]/g,"");if(t.length>=7)return k(t)}return Promise.resolve(null)}var A="https://optiq-collect-951694748196.europe-west2.run.app/e",b=864e5,P=30*6e4,S=()=>typeof window!="undefined"&&typeof document!="undefined";function p(n){try{return window.localStorage.getItem(`optiq_${n}`)}catch(t){return null}}function d(n,t){try{t===null?window.localStorage.removeItem(`optiq_${n}`):window.localStorage.setItem(`optiq_${n}`,t)}catch(e){}}function h(n){try{return JSON.parse(p(n)||"{}")||{}}catch(t){return{}}}function w(n){let t="abcdefghijklmnopqrstuvwxyz0123456789",e=new Uint8Array(n);typeof crypto!="undefined"&&crypto.getRandomValues&&crypto.getRandomValues(e);let r="";for(let s=0;s<n;s++)r+=t.charAt((e[s]||Math.floor(Math.random()*256))%36);return r}var y=class{constructor(t){this.queue=[];this.timer=null;this.lastPath=null;this.wired=!1;this.key=t.key,this.endpoint=t.endpoint||A,this.consentState=t.consent||p("consent")||"unknown";let e=new URLSearchParams(window.location.search),r=Date.now();this.touch=h("touch");let s=e.get("osr");if(s&&/^[A-Za-z0-9]{4,16}$/.test(s)){let l=new Date(r).toISOString();(!this.touch.first||r-Date.parse(this.touch.first.at)>90*b)&&(this.touch.first={ref:s,at:l}),this.touch.last={ref:s,at:l},d("touch",JSON.stringify(this.touch))}let i={};for(let l of["source","medium","campaign","content","term"]){let f=e.get(`utm_${l}`);f&&(i[l]=f.slice(0,200))}Object.keys(i).length&&d("utm",JSON.stringify(i)),this.utm=Object.keys(i).length?i:h("utm");let o={};for(let l of["gclid","fbclid","ttclid","wbraid","gbraid"]){let f=e.get(l);f&&(o[l]=f.slice(0,500))}Object.keys(o).length&&d("clicks",JSON.stringify(o)),this.clicks=Object.keys(o).length?o:h("clicks");let u=this.consentState==="denied"?{}:h("visit"),c=`${e.get("utm_campaign")||""}|${s||""}`;this.visit=u.id&&r-(u.last||0)<=P&&(c==="|"||c===u.from)?u:{id:w(20),started:new Date(r).toISOString(),from:c,landing:window.location.pathname,referrer:document.referrer?document.referrer.split("?")[0].slice(0,300):null,utm:i,click:e.get("gclid")?"gclid":e.get("fbclid")?"fbclid":e.get("ttclid")?"ttclid":null,ref:s&&/^[A-Za-z0-9]{4,16}$/.test(s)?s:null},this.person=p("ph"),t.auto!==!1&&this.wire()}visitor(){if(this.consentState==="denied")return null;let t=p("vid");return t||(t=w(20),d("vid",t)),t}context(){let t=null;try{t=Intl.DateTimeFormat().resolvedOptions().timeZone||null}catch(r){t=null}let e=this.visit;return{id:e.id,started_at:e.started,landing:e.landing,referrer:e.referrer,utm:e.utm,click:e.click,ref:e.ref,lang:(navigator.language||"").slice(0,20)||null,tz:t,screen:window.screen?`${window.screen.width}x${window.screen.height}`:null}}flush(){for(this.timer&&clearTimeout(this.timer),this.timer=null;this.queue.length;){let t=JSON.stringify({key:this.key,visit:this.context(),events:this.queue.splice(0,50)}),e=!1;try{e=!!(navigator.sendBeacon&&navigator.sendBeacon(this.endpoint,new Blob([t],{type:"text/plain"})))}catch(r){e=!1}if(!e)try{fetch(this.endpoint,{method:"POST",body:t,keepalive:!0,mode:"cors",headers:{"Content-Type":"text/plain"}}).catch(()=>{})}catch(r){}}}track(t,e={}){let r={};for(let[c,l]of Object.entries(e))!["value","currency","email","phone"].includes(c)&&l!==void 0&&(r[c]=l);let s=Date.now();this.visit.last=s,this.consentState!=="denied"&&d("visit",JSON.stringify(this.visit));let i=this.touch.last&&s-Date.parse(this.touch.last.at)<=7*b?this.touch.last:null,o=this.consentState==="denied",u={event_id:w(18),name:String(t||"").toLowerCase(),occurred_at:new Date(s).toISOString(),visitor_id:this.visitor(),page_url:window.location.origin+window.location.pathname,referrer:document.referrer?document.referrer.split("?")[0].slice(0,300):null,utm:this.utm,click_ids:o?{}:this.clicks,first_ref:this.touch.first?this.touch.first.ref:null,first_ref_at:this.touch.first?this.touch.first.at:null,last_ref:i?i.ref:null,last_ref_at:i?i.at:null,value:e.value===void 0?null:Number(e.value),currency:e.currency||null,properties:r,consent:this.consentState};m(o?null:e).then(c=>{c&&(this.person=c,d("ph",c)),u.person_hash=o?null:this.person,this.queue.push(u),this.timer||(this.timer=setTimeout(()=>this.flush(),400))})}identify(t){m(t).then(e=>{e&&this.consentState!=="denied"&&(this.person=e,d("ph",e))})}consent(t){if(this.consentState=t==="granted"||t==="denied"?t:"unknown",d("consent",this.consentState),this.consentState==="denied"){for(let e of["vid","ph","clicks","visit"])d(e,null);this.person=null,this.clicks={}}}page(){let t=window.location.pathname+window.location.search;t!==this.lastPath&&(this.lastPath=t,this.track("page_view"))}wire(){if(this.wired)return;this.wired=!0,this.page();for(let e of["pushState","replaceState"]){let r=history[e];typeof r=="function"&&(history[e]=function(...s){let i=r.apply(this,s);return setTimeout(()=>a==null?void 0:a.page(),0),i})}window.addEventListener("popstate",()=>this.page());let t=typeof WeakSet=="function"?new WeakSet:null;document.addEventListener("focusin",e=>{var s,i;let r=(i=(s=e.target)==null?void 0:s.closest)==null?void 0:i.call(s,"form");!r||!t||t.has(r)||(t.add(r),this.track("form_start",{form:(r.getAttribute("name")||r.id||"").slice(0,60)||void 0}))}),document.addEventListener("submit",e=>{let r=e.target;if(!r||!r.getAttribute||r.getAttribute("data-optiq")!=="lead")return;let s=r.querySelector('input[type="email"]'),i=r.querySelector('input[type="tel"]');this.track("lead",{form:(r.getAttribute("name")||r.id||"").slice(0,60)||void 0,email:s?s.value:void 0,phone:i?i.value:void 0}),this.flush()}),document.addEventListener("click",e=>{var i,o;let r=(o=(i=e.target)==null?void 0:i.closest)==null?void 0:o.call(i,"a[href]");if(!r)return;let s=L(r.getAttribute("href")||"");s&&(this.track("contact",{channel:s}),this.flush())},!0),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flush()}),window.addEventListener("pagehide",()=>this.flush())}};function L(n){return/^tel:/i.test(n)?"call":/^mailto:[^?]/i.test(n)?"email":/^https?:\/\/(wa\.me\/\+?[0-9]|api\.whatsapp\.com\/send\/?\?(.*&)?phone=)/i.test(n)?"whatsapp":null}var a=null,_=[];function q(n){return S()?a||(!n||typeof n.key!="string"||!/^pk_[A-Za-z0-9]{20,40}$/.test(n.key)?(console.warn("[optiq] init needs the source's publishable key (pk_...), from the Developer page."),null):(a=new y(n),_.splice(0).forEach(t=>t()),a)):null}var g=n=>{S()&&(a?n(a):_.push(()=>a&&n(a)))},v=(n,t)=>g(e=>e.track(n,t)),T=n=>g(t=>t.identify(n)),O=n=>g(t=>t.consent(n)),x=()=>g(n=>n.page());(function(){if(window.__optiqLoaded)return;window.__optiqLoaded=!0;let n=document.currentScript||document.querySelector('script[src*="/t.js"][data-key]');if(!n)return;let t=(window.optiq&&window.optiq.q||[]).map(i=>Array.prototype.slice.call(i));function e(i,o,u){i==="track"?v(String(o),u||{}):i==="identify"?T(o||{}):i==="consent"?O(o):i==="page"&&x()}let r=(...i)=>e(...i);r.track=(i,o)=>v(i,o),window.optiq=r;let s=t.filter(i=>i[0]==="consent").pop();q({key:n.getAttribute("data-key")||"",endpoint:n.getAttribute("data-endpoint")||void 0,consent:s&&(s[1]==="granted"||s[1]==="denied")?s[1]:void 0}),t.forEach(i=>e(...i))})();})();
+/* Optiq Studio Enterprise tracking 0.2.0: <script async src="https://enterprise.optiq.studio/t.js" data-key="pk_..."></script>. Built from @optiqstudio/track (packages/track); docs: https://enterprise.optiq.studio/developers */
+"use strict";(()=>{var j=Object.defineProperty;var q=Object.getOwnPropertySymbols;var D=Object.prototype.hasOwnProperty,K=Object.prototype.propertyIsEnumerable;var A=(n,t,e)=>t in n?j(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e,g=(n,t)=>{for(var e in t||(t={}))D.call(t,e)&&A(n,e,t[e]);if(q)for(var e of q(t))K.call(t,e)&&A(n,e,t[e]);return n};function P(n){let t=typeof globalThis!="undefined"?globalThis.crypto:void 0;return!t||!t.subtle||typeof TextEncoder=="undefined"?Promise.resolve(null):t.subtle.digest("SHA-256",new TextEncoder().encode(n)).then(e=>Array.from(new Uint8Array(e),s=>s.toString(16).padStart(2,"0")).join(""),()=>null)}async function w(n){if(n&&typeof n.email=="string"&&n.email.indexOf("@")>0){let t=await P(n.email.trim().toLowerCase());return t?{hash:t,kind:"email"}:null}if(n&&(typeof n.phone=="string"||typeof n.phone=="number")){let t=String(n.phone).replace(/[^0-9]/g,""),e=t.length>=7?await P(t):null;return e?{hash:e,kind:"phone"}:null}return null}var $="https://optiq-collect-951694748196.europe-west2.run.app/e",x=864e5,N=30*6e4,O=()=>typeof window!="undefined"&&typeof document!="undefined";function h(n){try{return window.localStorage.getItem(`optiq_${n}`)}catch(t){return null}}function u(n,t){try{t===null?window.localStorage.removeItem(`optiq_${n}`):window.localStorage.setItem(`optiq_${n}`,t)}catch(e){}}function m(n){try{return JSON.parse(h(n)||"{}")||{}}catch(t){return{}}}function k(n){let t="abcdefghijklmnopqrstuvwxyz0123456789",e=new Uint8Array(n);typeof crypto!="undefined"&&crypto.getRandomValues&&crypto.getRandomValues(e);let s="";for(let r=0;r<n;r++)s+=t.charAt((e[r]||Math.floor(Math.random()*256))%36);return s}var v=class{constructor(t){this.queue=[];this.timer=null;this.lastPath=null;this.wired=!1;this.key=t.key,this.endpoint=t.endpoint||$,this.consentState=t.consent||h("consent")||"unknown";let e=new URLSearchParams(window.location.search),s=Date.now();this.touch=m("touch");let r=e.get("osr");if(r&&/^[A-Za-z0-9]{4,16}$/.test(r)){let c=new Date(s).toISOString();(!this.touch.first||s-Date.parse(this.touch.first.at)>90*x)&&(this.touch.first={ref:r,at:c}),this.touch.last={ref:r,at:c},u("touch",JSON.stringify(this.touch))}let i={};for(let c of["source","medium","campaign","content","term"]){let p=e.get(`utm_${c}`);p&&(i[c]=p.slice(0,200))}Object.keys(i).length&&u("utm",JSON.stringify(i)),this.utm=Object.keys(i).length?i:m("utm");let a={};for(let c of["gclid","fbclid","ttclid","wbraid","gbraid"]){let p=e.get(c);p&&(a[c]=p.slice(0,500))}Object.keys(a).length&&u("clicks",JSON.stringify(a)),this.clicks=Object.keys(a).length?a:m("clicks");let o=this.consentState==="denied"?{}:m("visit"),l=`${e.get("utm_campaign")||""}|${r||""}`;this.visit=o.id&&s-(o.last||0)<=N&&(l==="|"||l===o.from)?o:{id:k(20),started:new Date(s).toISOString(),from:l,landing:window.location.pathname,referrer:document.referrer?document.referrer.split("?")[0].slice(0,300):null,utm:i,click:e.get("gclid")?"gclid":e.get("fbclid")?"fbclid":e.get("ttclid")?"ttclid":null,ref:r&&/^[A-Za-z0-9]{4,16}$/.test(r)?r:null},this.person=h("ph"),this.personKind=h("pk")||null,t.auto!==!1&&this.wire()}visitor(){if(this.consentState==="denied")return null;let t=h("vid");return t||(t=k(20),u("vid",t)),t}context(){let t=null;try{t=Intl.DateTimeFormat().resolvedOptions().timeZone||null}catch(s){t=null}let e=this.visit;return{id:e.id,started_at:e.started,landing:e.landing,referrer:e.referrer,utm:e.utm,click:e.click,ref:e.ref,lang:(navigator.language||"").slice(0,20)||null,tz:t,screen:window.screen?`${window.screen.width}x${window.screen.height}`:null}}flush(){for(this.timer&&clearTimeout(this.timer),this.timer=null;this.queue.length;){let t=JSON.stringify({key:this.key,visit:this.context(),events:this.queue.splice(0,50)}),e=!1;try{e=!!(navigator.sendBeacon&&navigator.sendBeacon(this.endpoint,new Blob([t],{type:"text/plain"})))}catch(s){e=!1}if(!e)try{fetch(this.endpoint,{method:"POST",body:t,keepalive:!0,mode:"cors",headers:{"Content-Type":"text/plain"}}).catch(()=>{})}catch(s){}}}track(t,e={}){let s={};for(let[l,c]of Object.entries(e))!["value","currency","email","phone","items"].includes(l)&&c!==void 0&&!Array.isArray(c)&&(s[l]=c);let r=Date.now();this.visit.last=r,this.consentState!=="denied"&&u("visit",JSON.stringify(this.visit));let i=this.touch.last&&r-Date.parse(this.touch.last.at)<=7*x?this.touch.last:null,a=this.consentState==="denied",o=g({event_id:k(18),name:String(t||"").toLowerCase(),occurred_at:new Date(r).toISOString(),visitor_id:this.visitor(),page_url:window.location.origin+window.location.pathname,referrer:document.referrer?document.referrer.split("?")[0].slice(0,300):null,utm:this.utm,click_ids:a?{}:g(g({},this.clicks),H()),first_ref:this.touch.first?this.touch.first.ref:null,first_ref_at:this.touch.first?this.touch.first.at:null,last_ref:i?i.ref:null,last_ref_at:i?i.at:null,value:e.value===void 0?null:Number(e.value),currency:e.currency||null,properties:s,consent:this.consentState},Array.isArray(e.items)&&e.items.length?{items:e.items.slice(0,50)}:{});w(a?null:e).then(l=>{l&&(this.person=l.hash,this.personKind=l.kind,u("ph",l.hash),u("pk",l.kind)),o.person_hash=a?null:this.person,o.person_kind=a||!this.person?null:this.personKind,this.queue.push(o),this.timer||(this.timer=setTimeout(()=>this.flush(),400))})}identify(t){w(t).then(e=>{e&&this.consentState!=="denied"&&(this.person=e.hash,this.personKind=e.kind,u("ph",e.hash),u("pk",e.kind))})}consent(t){if(this.consentState=t==="granted"||t==="denied"?t:"unknown",u("consent",this.consentState),this.consentState==="denied"){for(let e of["vid","ph","pk","clicks","visit"])u(e,null);this.person=null,this.personKind=null,this.clicks={}}}page(){let t=window.location.pathname+window.location.search;t!==this.lastPath&&(this.lastPath=t,this.track("page_view"),this.wired&&setTimeout(()=>this.shopSignals(t),1200))}shopSignals(t){if(t!==window.location.pathname+window.location.search)return;let e=new URLSearchParams(window.location.search),s=["q","s","search","query","keyword"].map(i=>e.get(i)).find(i=>i&&i.trim());s&&this.track("search",{query:s.trim().slice(0,200)});let r=J();r&&this.track("view_content",{items:[r.item],value:r.item.price,currency:r.currency})}wire(){if(this.wired)return;this.wired=!0,this.page();for(let e of["pushState","replaceState"]){let s=history[e];typeof s=="function"&&(history[e]=function(...r){let i=s.apply(this,r);return setTimeout(()=>d==null?void 0:d.page(),0),i})}window.addEventListener("popstate",()=>this.page());let t=typeof WeakSet=="function"?new WeakSet:null;document.addEventListener("focusin",e=>{var r,i;let s=(i=(r=e.target)==null?void 0:r.closest)==null?void 0:i.call(r,"form");!s||!t||t.has(s)||(t.add(s),this.track("form_start",{form:(s.getAttribute("name")||s.id||"").slice(0,60)||void 0}))}),document.addEventListener("submit",e=>{let s=e.target;if(!s||!s.getAttribute||s.getAttribute("data-optiq")!=="lead")return;let r=s.querySelector('input[type="email"]'),i=s.querySelector('input[type="tel"]');this.track("lead",{form:(s.getAttribute("name")||s.id||"").slice(0,60)||void 0,email:r?r.value:void 0,phone:i?i.value:void 0}),this.flush()}),document.addEventListener("click",e=>{var i,a;let s=(a=(i=e.target)==null?void 0:i.closest)==null?void 0:a.call(i,"a[href]");if(!s)return;let r=M(s.getAttribute("href")||"");r&&(this.track("contact",{channel:r}),this.flush())},!0),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flush()}),window.addEventListener("pagehide",()=>this.flush())}};function H(){let n={};try{for(let t of document.cookie.split(";")){let[e,...s]=t.trim().split("="),r=decodeURIComponent(s.join("=")||"").slice(0,300);r&&(e==="_fbp"?n.fbp=r:e==="_fbc"?n.fbc=r:e==="_ttp"&&(n.ttp=r))}}catch(t){}return n}function J(){var t,e;let n=document.querySelectorAll('script[type="application/ld+json"]');for(let s of Array.from(n)){let r;try{r=JSON.parse(s.textContent||"null")}catch(a){continue}let i=[r];for(;i.length;){let a=i.shift();if(Array.isArray(a)){i.push(...a);continue}if(!a||typeof a!="object")continue;let o=a;o["@graph"]&&i.push(o["@graph"]);let l=o["@type"];if(l!=="Product"&&!(Array.isArray(l)&&l.includes("Product")))continue;let c=Array.isArray(o.offers)?o.offers[0]:o.offers,p=String(o.sku||o.productID||o.gtin13||o.mpn||o["@id"]||o.url||o.name||"").slice(0,100);if(!p)continue;let S=typeof o.brand=="string"?o.brand:(t=o.brand)==null?void 0:t.name,_=Number((e=c==null?void 0:c.price)!=null?e:c==null?void 0:c.lowPrice),f={id:p};typeof o.name=="string"&&(f.name=o.name.slice(0,200)),typeof o.category=="string"&&(f.category=o.category.slice(0,120)),S&&(f.brand=String(S).slice(0,120)),Number.isFinite(_)&&(f.price=_);let E=typeof(c==null?void 0:c.priceCurrency)=="string"?c.priceCurrency.toUpperCase().slice(0,3):void 0;return{item:f,currency:E}}}return null}function M(n){return/^tel:/i.test(n)?"call":/^mailto:[^?]/i.test(n)?"email":/^https?:\/\/(wa\.me\/\+?[0-9]|api\.whatsapp\.com\/send\/?\?(.*&)?phone=)/i.test(n)?"whatsapp":null}var d=null,T=[];function R(n){return O()?d||(!n||typeof n.key!="string"||!/^pk_[A-Za-z0-9]{20,40}$/.test(n.key)?(console.warn("[optiq] init needs the source's publishable key (pk_...), from the Developer page."),null):(d=new v(n),T.splice(0).forEach(t=>t()),d)):null}var y=n=>{O()&&(d?n(d):T.push(()=>d&&n(d)))},b=(n,t)=>y(e=>e.track(n,t)),C=n=>y(t=>t.identify(n)),L=n=>y(t=>t.consent(n)),I=()=>y(n=>n.page());(function(){if(window.__optiqLoaded)return;window.__optiqLoaded=!0;let n=document.currentScript||document.querySelector('script[src*="/t.js"][data-key]');if(!n)return;let t=(window.optiq&&window.optiq.q||[]).map(i=>Array.prototype.slice.call(i));function e(i,a,o){i==="track"?b(String(a),o||{}):i==="identify"?C(a||{}):i==="consent"?L(a):i==="page"&&I()}let s=(...i)=>e(...i);s.track=(i,a)=>b(i,a),window.optiq=s;let r=t.filter(i=>i[0]==="consent").pop();R({key:n.getAttribute("data-key")||"",endpoint:n.getAttribute("data-endpoint")||void 0,consent:r&&(r[1]==="granted"||r[1]==="denied")?r[1]:void 0}),t.forEach(i=>e(...i))})();})();

package/package.json

@@ -1,8 +1,17 @@
 {
   "name": "@optiqstudio/track",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Optiq Studio Enterprise tracking: join every lead, sale and deposit to the video, post or advert that brought it. Browser and server.",
-  "keywords": ["optiq", "optiq studio", "attribution", "tracking", "conversions", "analytics", "marketing", "whatsapp"],
+  "keywords": [
+    "optiq",
+    "optiq studio",
+    "attribution",
+    "tracking",
+    "conversions",
+    "analytics",
+    "marketing",
+    "whatsapp"
+  ],
   "homepage": "https://enterprise.optiq.studio/developers",
   "license": "MIT",
   "author": "DaveLabs <info@davelabs.co> (https://davelabs.co)",
@@ -24,8 +33,14 @@
     },
     "./package.json": "./package.json"
   },
-  "files": ["dist", "README.md", "LICENSE"],
-  "engines": { "node": ">=20" },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
   "scripts": {
     "build": "node build.mjs",
     "test": "node --test test/*.test.mjs",