@optiqstudio/track 0.1.0 → 0.3.0

package/dist/browser.d.ts

@@ -10,6 +10,45 @@ export interface InitOptions {
     endpoint?: string;
     /** The visitor's choice, if the site already knows it. */
     consent?: Consent;
+    /** Where suggestions come from. Default: the Optiq Studio Enterprise API. */
+    api?: string;
+}
+/** A product to show a shopper, and why. */
+export interface Suggestion {
+    id: string;
+    name: string | null;
+    category: string | null;
+    brand: string | null;
+    price: number | null;
+    currency: string | null;
+    url: string | null;
+    image: string | null;
+    /** bought_together, viewed_together, in_category, popular or recently_viewed. */
+    reason: string;
+    /** The product it goes with (bought_together, viewed_together). */
+    because: string | null;
+}
+export interface SuggestOptions {
+    /** The product on screen: suggestions go with it, and it is left out. */
+    product?: string;
+    /** Product ids to leave out (what is already in the basket, for example). */
+    exclude?: string[];
+    /** How many, 1 to 24. Default 8. */
+    limit?: number;
+}
+/** 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;
+    /** The product's page. */
+    url?: string;
+    /** The product's picture. */
+    image?: string;
 }
 export interface Properties {
     /** A sale's or deposit's amount. */
@@ -20,19 +59,24 @@ 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";
+export declare const API = "https://enterpriseapi-951694748196.europe-west2.run.app";
 /** One tracker on one page. Most sites use the module functions below, which share one. */
 export declare class Tracker {
     private key;
     private endpoint;
+    private api;
     private consentState;
     private touch;
     private utm;
     private clicks;
     private visit;
     private person;
+    private personKind;
     private queue;
     private timer;
     private lastPath;
@@ -44,6 +88,11 @@ export declare class Tracker {
     flush(): void;
     /** Something a visitor did: a standard name (lead, sign_up, purchase, first_deposit, ...) or one of your own. */
     track(name: string, props?: Properties): void;
+    /** Products to show this shopper, from what they (and shoppers like them) looked at and bought, and why. */
+    suggest(o?: SuggestOptions): Promise<{
+        suggestions: Suggestion[];
+        recentlyViewed: Suggestion[];
+    }>;
     /** Who the visitor is, from now on: their email or phone, hashed here. */
     identify(p: {
         email?: string;
@@ -53,6 +102,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. */
@@ -72,3 +126,8 @@ export declare const consent: (state: Consent) => void;
 export declare const page: () => void;
 /** Sends what waits now. */
 export declare const flush: () => void;
+/** Products to show this shopper, and why (an empty list if anything goes wrong, so a page never breaks). */
+export declare function suggest(o?: SuggestOptions): Promise<{
+    suggestions: Suggestion[];
+    recentlyViewed: Suggestion[];
+}>;

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

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  API: () => API,
   COLLECTOR: () => COLLECTOR,
   Tracker: () => Tracker,
   consent: () => consent,
@@ -29,6 +30,7 @@ __export(index_exports, {
   identify: () => identify,
   init: () => init,
   page: () => page,
+  suggest: () => suggest,
   track: () => track
 });
 module.exports = __toCommonJS(index_exports);
@@ -42,6 +44,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")) {
@@ -53,6 +67,7 @@ function hashPerson(p) {
 
 // src/browser.ts
 var COLLECTOR = "https://optiq-collect-951694748196.europe-west2.run.app/e";
+var API = "https://enterpriseapi-951694748196.europe-west2.run.app";
 var DAY = 864e5;
 var IDLE = 30 * 6e4;
 var hasWindow = () => typeof window !== "undefined" && typeof document !== "undefined";
@@ -93,6 +108,7 @@ var Tracker = class {
     this.wired = false;
     this.key = o.key;
     this.endpoint = o.endpoint || COLLECTOR;
+    this.api = (o.api || API).replace(/\/+$/, "");
     this.consentState = o.consent || get("consent") || "unknown";
     const q = new URLSearchParams(window.location.search);
     const now = Date.now();
@@ -131,6 +147,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 +203,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 +217,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 +225,46 @@ 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);
     });
   }
+  /** Products to show this shopper, from what they (and shoppers like them) looked at and bought, and why. */
+  async suggest(o = {}) {
+    const q = new URLSearchParams({ key: this.key });
+    const visitor = this.consentState === "denied" ? null : get("vid");
+    if (visitor) q.set("visitor", visitor);
+    if (o.product) q.set("product", o.product);
+    if (o.exclude?.length) q.set("exclude", o.exclude.join(","));
+    if (o.limit) q.set("limit", String(o.limit));
+    try {
+      const r = await fetch(`${this.api}/api/v1/suggest?${q}`, { mode: "cors", credentials: "omit" });
+      if (!r.ok) return { suggestions: [], recentlyViewed: [] };
+      return await r.json();
+    } catch {
+      return { suggestions: [], recentlyViewed: [] };
+    }
+  }
   /** 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 +273,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 +285,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 +350,62 @@ 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 image = typeof o.image === "string" ? o.image : Array.isArray(o.image) ? o.image.find((x) => typeof x === "string") : o.image?.url;
+      if (typeof image === "string" && /^https?:\/\//.test(image)) item.image = image.slice(0, 500);
+      const page2 = typeof o.url === "string" && /^https?:\/\//.test(o.url) ? o.url : window.location.origin + window.location.pathname;
+      item.url = page2.slice(0, 500);
+      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";
@@ -326,3 +435,7 @@ var identify = (p) => later((t) => t.identify(p));
 var consent = (state) => later((t) => t.consent(state));
 var page = () => later((t) => t.page());
 var flush = () => later((t) => t.flush());
+function suggest(o) {
+  if (!hasWindow()) return Promise.resolve({ suggestions: [], recentlyViewed: [] });
+  return new Promise((resolve) => later((t) => void t.suggest(o).then(resolve)));
+}

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 { API, COLLECTOR, Tracker, consent, contactChannel, flush, hashPerson, identify, init, page, suggest, track } from "./browser";
+export type { Consent, InitOptions, Item, Properties, SuggestOptions, Suggestion } 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")) {
@@ -18,6 +30,7 @@ function hashPerson(p) {
 
 // src/browser.ts
 var COLLECTOR = "https://optiq-collect-951694748196.europe-west2.run.app/e";
+var API = "https://enterpriseapi-951694748196.europe-west2.run.app";
 var DAY = 864e5;
 var IDLE = 30 * 6e4;
 var hasWindow = () => typeof window !== "undefined" && typeof document !== "undefined";
@@ -58,6 +71,7 @@ var Tracker = class {
     this.wired = false;
     this.key = o.key;
     this.endpoint = o.endpoint || COLLECTOR;
+    this.api = (o.api || API).replace(/\/+$/, "");
     this.consentState = o.consent || get("consent") || "unknown";
     const q = new URLSearchParams(window.location.search);
     const now = Date.now();
@@ -96,6 +110,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 +166,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 +180,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 +188,46 @@ 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);
     });
   }
+  /** Products to show this shopper, from what they (and shoppers like them) looked at and bought, and why. */
+  async suggest(o = {}) {
+    const q = new URLSearchParams({ key: this.key });
+    const visitor = this.consentState === "denied" ? null : get("vid");
+    if (visitor) q.set("visitor", visitor);
+    if (o.product) q.set("product", o.product);
+    if (o.exclude?.length) q.set("exclude", o.exclude.join(","));
+    if (o.limit) q.set("limit", String(o.limit));
+    try {
+      const r = await fetch(`${this.api}/api/v1/suggest?${q}`, { mode: "cors", credentials: "omit" });
+      if (!r.ok) return { suggestions: [], recentlyViewed: [] };
+      return await r.json();
+    } catch {
+      return { suggestions: [], recentlyViewed: [] };
+    }
+  }
   /** 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 +236,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 +248,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 +313,62 @@ 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 image = typeof o.image === "string" ? o.image : Array.isArray(o.image) ? o.image.find((x) => typeof x === "string") : o.image?.url;
+      if (typeof image === "string" && /^https?:\/\//.test(image)) item.image = image.slice(0, 500);
+      const page2 = typeof o.url === "string" && /^https?:\/\//.test(o.url) ? o.url : window.location.origin + window.location.pathname;
+      item.url = page2.slice(0, 500);
+      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";
@@ -291,7 +398,12 @@ var identify = (p) => later((t) => t.identify(p));
 var consent = (state) => later((t) => t.consent(state));
 var page = () => later((t) => t.page());
 var flush = () => later((t) => t.flush());
+function suggest(o) {
+  if (!hasWindow()) return Promise.resolve({ suggestions: [], recentlyViewed: [] });
+  return new Promise((resolve) => later((t) => void t.suggest(o).then(resolve)));
+}
 export {
+  API,
   COLLECTOR,
   Tracker,
   consent,
@@ -301,5 +413,6 @@ export {
   identify,
   init,
   page,
+  suggest,
   track
 };

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")) {
@@ -58,7 +70,7 @@ var OptiqError = class extends Error {
     this.name = "OptiqError";
   }
 };
-var Optiq = class {
+var Optiq = class _Optiq {
   constructor(o) {
     if (!o || typeof o.secretKey !== "string" || !/^sk_[A-Za-z0-9]{30,60}$/.test(o.secretKey)) {
       throw new Error("Optiq needs the source's secret key (sk_...), from the Developer page.");
@@ -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. */
@@ -114,6 +127,33 @@ var Optiq = class {
     }
     return out;
   }
+  async get(path) {
+    const r = await fetch(`${this.baseUrl}${path}`, { headers: { Authorization: `Bearer ${this.secretKey}` } });
+    const data = await r.json().catch(() => ({}));
+    if (!r.ok) throw new OptiqError(typeof data.error === "string" ? data.error : `Optiq answered ${r.status}.`, r.status);
+    return data;
+  }
+  static who(w) {
+    const q = new URLSearchParams();
+    if (w.person_hash) q.set("person_hash", w.person_hash);
+    else if (w.email) q.set("email", w.email);
+    else if (w.phone !== void 0) q.set("phone", String(w.phone));
+    if (w.visitor_id) q.set("visitor_id", w.visitor_id);
+    return q;
+  }
+  /** Products to offer one customer (across every device they used), and why: for your pages, emails and messages. */
+  async suggest(o) {
+    const q = _Optiq.who(o);
+    if (o.visitor_id) q.set("visitor", o.visitor_id);
+    if (o.product) q.set("product", o.product);
+    if (o.exclude?.length) q.set("exclude", o.exclude.join(","));
+    if (o.limit) q.set("limit", String(o.limit));
+    return this.get(`/api/v1/suggest?${q}`);
+  }
+  /** Everything your company knows about one customer: visits, sources, products, orders, spend, segment, a timeline. */
+  async profile(who) {
+    return this.get(`/api/v1/people?${_Optiq.who(who)}`);
+  }
   /** Forgets a customer in your company: every event and visit of theirs. Answers how many events went. */
   async forget(who) {
     const hash = who.person_hash || await hashPerson(who);

package/dist/server.d.ts

@@ -12,6 +12,20 @@ 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;
+        url?: string;
+        image?: string;
+    }[];
     /** The browser's visitor id, if your site passes it to your server (localStorage optiq_vid). */
     visitor_id?: string;
     value?: number;
@@ -58,6 +72,28 @@ export declare class Optiq {
     private prepare;
     /** Sends one event or many (any number: they go 500 at a time). Answers what was kept, repeated or refused. */
     track(events: ServerEvent | ServerEvent[]): Promise<TrackResult>;
+    private get;
+    private static who;
+    /** Products to offer one customer (across every device they used), and why: for your pages, emails and messages. */
+    suggest(o: {
+        email?: string;
+        phone?: string | number;
+        person_hash?: string;
+        visitor_id?: string;
+        product?: string;
+        exclude?: string[];
+        limit?: number;
+    }): Promise<{
+        suggestions: Record<string, unknown>[];
+        recentlyViewed: Record<string, unknown>[];
+    }>;
+    /** Everything your company knows about one customer: visits, sources, products, orders, spend, segment, a timeline. */
+    profile(who: {
+        email?: string;
+        phone?: string | number;
+        person_hash?: string;
+        visitor_id?: string;
+    }): Promise<Record<string, unknown>>;
     /** Forgets a customer in your company: every event and visit of theirs. Answers how many events went. */
     forget(who: {
         email?: string;

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")) {
@@ -31,7 +43,7 @@ var OptiqError = class extends Error {
     this.name = "OptiqError";
   }
 };
-var Optiq = class {
+var Optiq = class _Optiq {
   constructor(o) {
     if (!o || typeof o.secretKey !== "string" || !/^sk_[A-Za-z0-9]{30,60}$/.test(o.secretKey)) {
       throw new Error("Optiq needs the source's secret key (sk_...), from the Developer page.");
@@ -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. */
@@ -87,6 +100,33 @@ var Optiq = class {
     }
     return out;
   }
+  async get(path) {
+    const r = await fetch(`${this.baseUrl}${path}`, { headers: { Authorization: `Bearer ${this.secretKey}` } });
+    const data = await r.json().catch(() => ({}));
+    if (!r.ok) throw new OptiqError(typeof data.error === "string" ? data.error : `Optiq answered ${r.status}.`, r.status);
+    return data;
+  }
+  static who(w) {
+    const q = new URLSearchParams();
+    if (w.person_hash) q.set("person_hash", w.person_hash);
+    else if (w.email) q.set("email", w.email);
+    else if (w.phone !== void 0) q.set("phone", String(w.phone));
+    if (w.visitor_id) q.set("visitor_id", w.visitor_id);
+    return q;
+  }
+  /** Products to offer one customer (across every device they used), and why: for your pages, emails and messages. */
+  async suggest(o) {
+    const q = _Optiq.who(o);
+    if (o.visitor_id) q.set("visitor", o.visitor_id);
+    if (o.product) q.set("product", o.product);
+    if (o.exclude?.length) q.set("exclude", o.exclude.join(","));
+    if (o.limit) q.set("limit", String(o.limit));
+    return this.get(`/api/v1/suggest?${q}`);
+  }
+  /** Everything your company knows about one customer: visits, sources, products, orders, spend, segment, a timeline. */
+  async profile(who) {
+    return this.get(`/api/v1/people?${_Optiq.who(who)}`);
+  }
   /** Forgets a customer in your company: every event and visit of theirs. Answers how many events went. */
   async forget(who) {
     const hash = who.person_hash || await hashPerson(who);

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.3.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 N=Object.defineProperty;var x=Object.getOwnPropertySymbols;var H=Object.prototype.hasOwnProperty,U=Object.prototype.propertyIsEnumerable;var O=(n,t,e)=>t in n?N(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e,m=(n,t)=>{for(var e in t||(t={}))H.call(t,e)&&O(n,e,t[e]);if(x)for(var e of x(t))U.call(t,e)&&O(n,e,t[e]);return n};function T(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)}async function k(n){if(n&&typeof n.email=="string"&&n.email.indexOf("@")>0){let t=await T(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 T(t):null;return e?{hash:e,kind:"phone"}:null}return null}var J="https://optiq-collect-951694748196.europe-west2.run.app/e",M="https://enterpriseapi-951694748196.europe-west2.run.app",R=864e5,z=30*6e4,S=()=>typeof window!="undefined"&&typeof document!="undefined";function f(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 y(n){try{return JSON.parse(f(n)||"{}")||{}}catch(t){return{}}}function v(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 b=class{constructor(t){this.queue=[];this.timer=null;this.lastPath=null;this.wired=!1;this.key=t.key,this.endpoint=t.endpoint||J,this.api=(t.api||M).replace(/\/+$/,""),this.consentState=t.consent||f("consent")||"unknown";let e=new URLSearchParams(window.location.search),r=Date.now();this.touch=y("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*R)&&(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 u=e.get(`utm_${l}`);u&&(i[l]=u.slice(0,200))}Object.keys(i).length&&d("utm",JSON.stringify(i)),this.utm=Object.keys(i).length?i:y("utm");let a={};for(let l of["gclid","fbclid","ttclid","wbraid","gbraid"]){let u=e.get(l);u&&(a[l]=u.slice(0,500))}Object.keys(a).length&&d("clicks",JSON.stringify(a)),this.clicks=Object.keys(a).length?a:y("clicks");let c=this.consentState==="denied"?{}:y("visit"),o=`${e.get("utm_campaign")||""}|${s||""}`;this.visit=c.id&&r-(c.last||0)<=z&&(o==="|"||o===c.from)?c:{id:v(20),started:new Date(r).toISOString(),from:o,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=f("ph"),this.personKind=f("pk")||null,t.auto!==!1&&this.wire()}visitor(){if(this.consentState==="denied")return null;let t=f("vid");return t||(t=v(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[o,l]of Object.entries(e))!["value","currency","email","phone","items"].includes(o)&&l!==void 0&&!Array.isArray(l)&&(r[o]=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*R?this.touch.last:null,a=this.consentState==="denied",c=m({event_id:v(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:a?{}:m(m({},this.clicks),W()),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},Array.isArray(e.items)&&e.items.length?{items:e.items.slice(0,50)}:{});k(a?null:e).then(o=>{o&&(this.person=o.hash,this.personKind=o.kind,d("ph",o.hash),d("pk",o.kind)),c.person_hash=a?null:this.person,c.person_kind=a||!this.person?null:this.personKind,this.queue.push(c),this.timer||(this.timer=setTimeout(()=>this.flush(),400))})}async suggest(t={}){var s;let e=new URLSearchParams({key:this.key}),r=this.consentState==="denied"?null:f("vid");r&&e.set("visitor",r),t.product&&e.set("product",t.product),(s=t.exclude)!=null&&s.length&&e.set("exclude",t.exclude.join(",")),t.limit&&e.set("limit",String(t.limit));try{let i=await fetch(`${this.api}/api/v1/suggest?${e}`,{mode:"cors",credentials:"omit"});return i.ok?await i.json():{suggestions:[],recentlyViewed:[]}}catch(i){return{suggestions:[],recentlyViewed:[]}}}identify(t){k(t).then(e=>{e&&this.consentState!=="denied"&&(this.person=e.hash,this.personKind=e.kind,d("ph",e.hash),d("pk",e.kind))})}consent(t){if(this.consentState=t==="granted"||t==="denied"?t:"unknown",d("consent",this.consentState),this.consentState==="denied"){for(let e of["vid","ph","pk","clicks","visit"])d(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),r=["q","s","search","query","keyword"].map(i=>e.get(i)).find(i=>i&&i.trim());r&&this.track("search",{query:r.trim().slice(0,200)});let s=Z();s&&this.track("view_content",{items:[s.item],value:s.item.price,currency:s.currency})}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(()=>g==null?void 0:g.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,a;let r=(a=(i=e.target)==null?void 0:i.closest)==null?void 0:a.call(i,"a[href]");if(!r)return;let s=B(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 W(){let n={};try{for(let t of document.cookie.split(";")){let[e,...r]=t.trim().split("="),s=decodeURIComponent(r.join("=")||"").slice(0,300);s&&(e==="_fbp"?n.fbp=s:e==="_fbc"?n.fbc=s:e==="_ttp"&&(n.ttp=s))}}catch(t){}return n}function Z(){var t,e,r;let n=document.querySelectorAll('script[type="application/ld+json"]');for(let s of Array.from(n)){let i;try{i=JSON.parse(s.textContent||"null")}catch(c){continue}let a=[i];for(;a.length;){let c=a.shift();if(Array.isArray(c)){a.push(...c);continue}if(!c||typeof c!="object")continue;let o=c;o["@graph"]&&a.push(o["@graph"]);let l=o["@type"];if(l!=="Product"&&!(Array.isArray(l)&&l.includes("Product")))continue;let u=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 A=typeof o.brand=="string"?o.brand:(t=o.brand)==null?void 0:t.name,q=Number((e=u==null?void 0:u.price)!=null?e:u==null?void 0:u.lowPrice),p={id:P};typeof o.name=="string"&&(p.name=o.name.slice(0,200)),typeof o.category=="string"&&(p.category=o.category.slice(0,120)),A&&(p.brand=String(A).slice(0,120)),Number.isFinite(q)&&(p.price=q);let w=typeof o.image=="string"?o.image:Array.isArray(o.image)?o.image.find(V=>typeof V=="string"):(r=o.image)==null?void 0:r.url;typeof w=="string"&&/^https?:\/\//.test(w)&&(p.image=w.slice(0,500));let D=typeof o.url=="string"&&/^https?:\/\//.test(o.url)?o.url:window.location.origin+window.location.pathname;p.url=D.slice(0,500);let K=typeof(u==null?void 0:u.priceCurrency)=="string"?u.priceCurrency.toUpperCase().slice(0,3):void 0;return{item:p,currency:K}}}return null}function B(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 g=null,C=[];function L(n){return S()?g||(!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):(g=new b(n),C.splice(0).forEach(t=>t()),g)):null}var h=n=>{S()&&(g?n(g):C.push(()=>g&&n(g)))},_=(n,t)=>h(e=>e.track(n,t)),I=n=>h(t=>t.identify(n)),E=n=>h(t=>t.consent(n)),j=()=>h(n=>n.page());function $(n){return S()?new Promise(t=>h(e=>void e.suggest(n).then(t))):Promise.resolve({suggestions:[],recentlyViewed:[]})}(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,c){i==="track"?_(String(a),c||{}):i==="identify"?I(a||{}):i==="consent"?E(a):i==="page"&&j()}let r=(...i)=>e(...i);r.track=(i,a)=>_(i,a),r.suggest=i=>$(i),window.optiq=r;let s=t.filter(i=>i[0]==="consent").pop();L({key:n.getAttribute("data-key")||"",endpoint:n.getAttribute("data-endpoint")||void 0,api:n.getAttribute("data-api")||void 0,consent:s&&(s[1]==="granted"||s[1]==="denied")?s[1]:void 0}),t.forEach(i=>e(...i))})();})();

package/package.json

@@ -1,8 +1,17 @@
 {
   "name": "@optiqstudio/track",
-  "version": "0.1.0",
+  "version": "0.3.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",