@optiqstudio/track 0.2.0 → 0.4.0

package/README.md

@@ -28,7 +28,11 @@ Sent by itself:
 - page views, including single-page moves;
 - form starts;
 - leads from forms marked `data-optiq="lead"`;
-- presses on WhatsApp, call and email links.
+- presses on WhatsApp, call and email links;
+- how far each visitor watches each video on the page (`video_progress`: at the start, at 25, 50, 75 and 100%,
+  with the seconds actually played). Any player built on `<video>` counts when it plays with sound or its own
+  controls; a muted background loop does not. Name a video with `data-optiq-video="Spring advert"`, or leave one
+  out with `data-optiq-video="off"`.
 
 `init({ key, auto: false })` turns these off. Call `page()` yourself when they are off.
 

package/dist/browser.d.ts

@@ -10,6 +10,31 @@ 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 {
@@ -20,6 +45,10 @@ export interface Item {
     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. */
@@ -35,10 +64,12 @@ export interface Properties {
     [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;
@@ -48,6 +79,9 @@ export declare class Tracker {
     private personKind;
     private queue;
     private timer;
+    /** Events still being hashed (a moment), and whether a flush asked for them to go the moment they are ready. */
+    private hashing;
+    private urgent;
     private lastPath;
     private wired;
     constructor(o: InitOptions);
@@ -57,6 +91,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;
@@ -90,3 +129,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/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);
@@ -65,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";
@@ -101,10 +104,14 @@ var Tracker = class {
   constructor(o) {
     this.queue = [];
     this.timer = null;
+    /** Events still being hashed (a moment), and whether a flush asked for them to go the moment they are ready. */
+    this.hashing = 0;
+    this.urgent = false;
     this.lastPath = null;
     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();
@@ -180,6 +187,7 @@ var Tracker = class {
   flush() {
     if (this.timer) clearTimeout(this.timer);
     this.timer = null;
+    if (this.hashing) this.urgent = true;
     while (this.queue.length) {
       const body = JSON.stringify({ key: this.key, visit: this.context(), events: this.queue.splice(0, 50) });
       let sent = false;
@@ -224,7 +232,9 @@ var Tracker = class {
       consent: this.consentState,
       ...Array.isArray(props.items) && props.items.length ? { items: props.items.slice(0, 50) } : {}
     };
+    this.hashing++;
     void personOf(denied ? null : props).then((h) => {
+      this.hashing--;
       if (h) {
         this.person = h.hash;
         this.personKind = h.kind;
@@ -234,9 +244,28 @@ var Tracker = class {
       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);
+      if (this.urgent && !this.hashing) {
+        this.urgent = false;
+        this.flush();
+      } else 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 personOf(p).then((h) => {
@@ -324,12 +353,108 @@ var Tracker = class {
       },
       true
     );
+    watchVideos((p) => this.track("video_progress", p));
     document.addEventListener("visibilitychange", () => {
       if (document.visibilityState === "hidden") this.flush();
     });
     window.addEventListener("pagehide", () => this.flush());
   }
 };
+function watchVideos(send) {
+  if (typeof WeakMap !== "function") return;
+  const seen = /* @__PURE__ */ new WeakMap();
+  const playing = [];
+  const nameOf = (v) => {
+    const marked = v.getAttribute("data-optiq-video");
+    if (marked && marked !== "on") return marked.slice(0, 120);
+    const label = v.getAttribute("title") || v.getAttribute("aria-label");
+    if (label) return label.slice(0, 120);
+    for (const u of [v.currentSrc, v.getAttribute("src"), v.poster]) {
+      if (!u || u.indexOf("blob:") === 0 || u.indexOf("data:") === 0) continue;
+      const file = u.split("?")[0].split("#")[0].split("/").filter(Boolean).pop();
+      if (file) {
+        try {
+          return decodeURIComponent(file).slice(0, 120);
+        } catch {
+          return file.slice(0, 120);
+        }
+      }
+    }
+    return (document.title || "video").slice(0, 120);
+  };
+  const counts = (v) => {
+    const marked = v.getAttribute("data-optiq-video");
+    if (marked === "off") return false;
+    if (marked) return true;
+    return !v.loop && (v.controls || !v.muted);
+  };
+  const report = (v, s, percent) => {
+    const duration = Number.isFinite(v.duration) && v.duration > 0 ? Math.round(v.duration) : void 0;
+    send({ video: nameOf(v), percent, seconds: Math.round(s.played), duration });
+    s.sent = s.played;
+  };
+  const videoOf = (e) => typeof HTMLVideoElement !== "undefined" && e.target instanceof HTMLVideoElement ? e.target : null;
+  document.addEventListener(
+    "play",
+    (e) => {
+      const v = videoOf(e);
+      if (!v) return;
+      let s = seen.get(v);
+      if (!s) {
+        s = { at: v.currentTime, played: 0, sent: 0, reached: -1, counted: null };
+        seen.set(v, s);
+      }
+      s.at = v.currentTime;
+      if (s.counted === null) s.counted = counts(v);
+      if (!s.counted) return;
+      if (playing.indexOf(v) < 0) playing.push(v);
+      if (s.reached < 0) {
+        s.reached = 0;
+        report(v, s, 0);
+      }
+    },
+    true
+  );
+  document.addEventListener(
+    "timeupdate",
+    (e) => {
+      const v = videoOf(e);
+      const s = v ? seen.get(v) : void 0;
+      if (!v || !s || !s.counted) return;
+      const step = v.currentTime - s.at;
+      if (step > 0 && step < 2.5) s.played += step;
+      s.at = v.currentTime;
+      if (!Number.isFinite(v.duration) || v.duration <= 0) return;
+      const quarter = Math.min(100, Math.floor(v.currentTime / v.duration * 4) * 25);
+      if (quarter >= 25 && quarter > s.reached) {
+        s.reached = quarter;
+        report(v, s, quarter);
+      }
+    },
+    true
+  );
+  document.addEventListener(
+    "ended",
+    (e) => {
+      const v = videoOf(e);
+      const s = v ? seen.get(v) : void 0;
+      if (!v || !s || !s.counted || s.reached >= 100) return;
+      s.reached = 100;
+      report(v, s, 100);
+    },
+    true
+  );
+  const leaving = () => {
+    for (const v of playing) {
+      const s = seen.get(v);
+      if (s && s.played - s.sent >= 3) report(v, s, Math.max(0, s.reached));
+    }
+  };
+  document.addEventListener("visibilitychange", () => {
+    if (document.visibilityState === "hidden") leaving();
+  });
+  window.addEventListener("pagehide", leaving);
+}
 function platformCookies() {
   const out = {};
   try {
@@ -376,6 +501,10 @@ function pageProduct() {
       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 };
     }
@@ -411,3 +540,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, Item, 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

@@ -30,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";
@@ -66,10 +67,14 @@ var Tracker = class {
   constructor(o) {
     this.queue = [];
     this.timer = null;
+    /** Events still being hashed (a moment), and whether a flush asked for them to go the moment they are ready. */
+    this.hashing = 0;
+    this.urgent = false;
     this.lastPath = null;
     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();
@@ -145,6 +150,7 @@ var Tracker = class {
   flush() {
     if (this.timer) clearTimeout(this.timer);
     this.timer = null;
+    if (this.hashing) this.urgent = true;
     while (this.queue.length) {
       const body = JSON.stringify({ key: this.key, visit: this.context(), events: this.queue.splice(0, 50) });
       let sent = false;
@@ -189,7 +195,9 @@ var Tracker = class {
       consent: this.consentState,
       ...Array.isArray(props.items) && props.items.length ? { items: props.items.slice(0, 50) } : {}
     };
+    this.hashing++;
     void personOf(denied ? null : props).then((h) => {
+      this.hashing--;
       if (h) {
         this.person = h.hash;
         this.personKind = h.kind;
@@ -199,9 +207,28 @@ var Tracker = class {
       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);
+      if (this.urgent && !this.hashing) {
+        this.urgent = false;
+        this.flush();
+      } else 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 personOf(p).then((h) => {
@@ -289,12 +316,108 @@ var Tracker = class {
       },
       true
     );
+    watchVideos((p) => this.track("video_progress", p));
     document.addEventListener("visibilitychange", () => {
       if (document.visibilityState === "hidden") this.flush();
     });
     window.addEventListener("pagehide", () => this.flush());
   }
 };
+function watchVideos(send) {
+  if (typeof WeakMap !== "function") return;
+  const seen = /* @__PURE__ */ new WeakMap();
+  const playing = [];
+  const nameOf = (v) => {
+    const marked = v.getAttribute("data-optiq-video");
+    if (marked && marked !== "on") return marked.slice(0, 120);
+    const label = v.getAttribute("title") || v.getAttribute("aria-label");
+    if (label) return label.slice(0, 120);
+    for (const u of [v.currentSrc, v.getAttribute("src"), v.poster]) {
+      if (!u || u.indexOf("blob:") === 0 || u.indexOf("data:") === 0) continue;
+      const file = u.split("?")[0].split("#")[0].split("/").filter(Boolean).pop();
+      if (file) {
+        try {
+          return decodeURIComponent(file).slice(0, 120);
+        } catch {
+          return file.slice(0, 120);
+        }
+      }
+    }
+    return (document.title || "video").slice(0, 120);
+  };
+  const counts = (v) => {
+    const marked = v.getAttribute("data-optiq-video");
+    if (marked === "off") return false;
+    if (marked) return true;
+    return !v.loop && (v.controls || !v.muted);
+  };
+  const report = (v, s, percent) => {
+    const duration = Number.isFinite(v.duration) && v.duration > 0 ? Math.round(v.duration) : void 0;
+    send({ video: nameOf(v), percent, seconds: Math.round(s.played), duration });
+    s.sent = s.played;
+  };
+  const videoOf = (e) => typeof HTMLVideoElement !== "undefined" && e.target instanceof HTMLVideoElement ? e.target : null;
+  document.addEventListener(
+    "play",
+    (e) => {
+      const v = videoOf(e);
+      if (!v) return;
+      let s = seen.get(v);
+      if (!s) {
+        s = { at: v.currentTime, played: 0, sent: 0, reached: -1, counted: null };
+        seen.set(v, s);
+      }
+      s.at = v.currentTime;
+      if (s.counted === null) s.counted = counts(v);
+      if (!s.counted) return;
+      if (playing.indexOf(v) < 0) playing.push(v);
+      if (s.reached < 0) {
+        s.reached = 0;
+        report(v, s, 0);
+      }
+    },
+    true
+  );
+  document.addEventListener(
+    "timeupdate",
+    (e) => {
+      const v = videoOf(e);
+      const s = v ? seen.get(v) : void 0;
+      if (!v || !s || !s.counted) return;
+      const step = v.currentTime - s.at;
+      if (step > 0 && step < 2.5) s.played += step;
+      s.at = v.currentTime;
+      if (!Number.isFinite(v.duration) || v.duration <= 0) return;
+      const quarter = Math.min(100, Math.floor(v.currentTime / v.duration * 4) * 25);
+      if (quarter >= 25 && quarter > s.reached) {
+        s.reached = quarter;
+        report(v, s, quarter);
+      }
+    },
+    true
+  );
+  document.addEventListener(
+    "ended",
+    (e) => {
+      const v = videoOf(e);
+      const s = v ? seen.get(v) : void 0;
+      if (!v || !s || !s.counted || s.reached >= 100) return;
+      s.reached = 100;
+      report(v, s, 100);
+    },
+    true
+  );
+  const leaving = () => {
+    for (const v of playing) {
+      const s = seen.get(v);
+      if (s && s.played - s.sent >= 3) report(v, s, Math.max(0, s.reached));
+    }
+  };
+  document.addEventListener("visibilitychange", () => {
+    if (document.visibilityState === "hidden") leaving();
+  });
+  window.addEventListener("pagehide", leaving);
+}
 function platformCookies() {
   const out = {};
   try {
@@ -341,6 +464,10 @@ function pageProduct() {
       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 };
     }
@@ -376,7 +503,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,
@@ -386,5 +518,6 @@ export {
   identify,
   init,
   page,
+  suggest,
   track
 };

package/dist/server.cjs

@@ -70,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.");
@@ -127,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

@@ -23,6 +23,8 @@ export interface ServerEvent {
         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;
@@ -70,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

@@ -43,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.");
@@ -100,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.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))})();})();
+/* Optiq Studio Enterprise tracking 0.4.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 D=Object.defineProperty;var x=Object.getOwnPropertySymbols;var K=Object.prototype.hasOwnProperty,N=Object.prototype.propertyIsEnumerable;var q=(i,t,e)=>t in i?D(i,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):i[t]=e,w=(i,t)=>{for(var e in t||(t={}))K.call(t,e)&&q(i,e,t[e]);if(x)for(var e of x(t))N.call(t,e)&&q(i,e,t[e]);return i};function O(i){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(i)).then(e=>Array.from(new Uint8Array(e),o=>o.toString(16).padStart(2,"0")).join(""),()=>null)}async function S(i){if(i&&typeof i.email=="string"&&i.email.indexOf("@")>0){let t=await O(i.email.trim().toLowerCase());return t?{hash:t,kind:"email"}:null}if(i&&(typeof i.phone=="string"||typeof i.phone=="number")){let t=String(i.phone).replace(/[^0-9]/g,""),e=t.length>=7?await O(t):null;return e?{hash:e,kind:"phone"}:null}return null}var U="https://optiq-collect-951694748196.europe-west2.run.app/e",J="https://enterpriseapi-951694748196.europe-west2.run.app",L=864e5,W=30*6e4,P=()=>typeof window!="undefined"&&typeof document!="undefined";function m(i){try{return window.localStorage.getItem(`optiq_${i}`)}catch(t){return null}}function p(i,t){try{t===null?window.localStorage.removeItem(`optiq_${i}`):window.localStorage.setItem(`optiq_${i}`,t)}catch(e){}}function v(i){try{return JSON.parse(m(i)||"{}")||{}}catch(t){return{}}}function _(i){let t="abcdefghijklmnopqrstuvwxyz0123456789",e=new Uint8Array(i);typeof crypto!="undefined"&&crypto.getRandomValues&&crypto.getRandomValues(e);let o="";for(let a=0;a<i;a++)o+=t.charAt((e[a]||Math.floor(Math.random()*256))%36);return o}var A=class{constructor(t){this.queue=[];this.timer=null;this.hashing=0;this.urgent=!1;this.lastPath=null;this.wired=!1;this.key=t.key,this.endpoint=t.endpoint||U,this.api=(t.api||J).replace(/\/+$/,""),this.consentState=t.consent||m("consent")||"unknown";let e=new URLSearchParams(window.location.search),o=Date.now();this.touch=v("touch");let a=e.get("osr");if(a&&/^[A-Za-z0-9]{4,16}$/.test(a)){let r=new Date(o).toISOString();(!this.touch.first||o-Date.parse(this.touch.first.at)>90*L)&&(this.touch.first={ref:a,at:r}),this.touch.last={ref:a,at:r},p("touch",JSON.stringify(this.touch))}let s={};for(let r of["source","medium","campaign","content","term"]){let c=e.get(`utm_${r}`);c&&(s[r]=c.slice(0,200))}Object.keys(s).length&&p("utm",JSON.stringify(s)),this.utm=Object.keys(s).length?s:v("utm");let u={};for(let r of["gclid","fbclid","ttclid","wbraid","gbraid"]){let c=e.get(r);c&&(u[r]=c.slice(0,500))}Object.keys(u).length&&p("clicks",JSON.stringify(u)),this.clicks=Object.keys(u).length?u:v("clicks");let l=this.consentState==="denied"?{}:v("visit"),n=`${e.get("utm_campaign")||""}|${a||""}`;this.visit=l.id&&o-(l.last||0)<=W&&(n==="|"||n===l.from)?l:{id:_(20),started:new Date(o).toISOString(),from:n,landing:window.location.pathname,referrer:document.referrer?document.referrer.split("?")[0].slice(0,300):null,utm:s,click:e.get("gclid")?"gclid":e.get("fbclid")?"fbclid":e.get("ttclid")?"ttclid":null,ref:a&&/^[A-Za-z0-9]{4,16}$/.test(a)?a:null},this.person=m("ph"),this.personKind=m("pk")||null,t.auto!==!1&&this.wire()}visitor(){if(this.consentState==="denied")return null;let t=m("vid");return t||(t=_(20),p("vid",t)),t}context(){let t=null;try{t=Intl.DateTimeFormat().resolvedOptions().timeZone||null}catch(o){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.hashing&&(this.urgent=!0);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(o){e=!1}if(!e)try{fetch(this.endpoint,{method:"POST",body:t,keepalive:!0,mode:"cors",headers:{"Content-Type":"text/plain"}}).catch(()=>{})}catch(o){}}}track(t,e={}){let o={};for(let[n,r]of Object.entries(e))!["value","currency","email","phone","items"].includes(n)&&r!==void 0&&!Array.isArray(r)&&(o[n]=r);let a=Date.now();this.visit.last=a,this.consentState!=="denied"&&p("visit",JSON.stringify(this.visit));let s=this.touch.last&&a-Date.parse(this.touch.last.at)<=7*L?this.touch.last:null,u=this.consentState==="denied",l=w({event_id:_(18),name:String(t||"").toLowerCase(),occurred_at:new Date(a).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:u?{}:w(w({},this.clicks),F()),first_ref:this.touch.first?this.touch.first.ref:null,first_ref_at:this.touch.first?this.touch.first.at:null,last_ref:s?s.ref:null,last_ref_at:s?s.at:null,value:e.value===void 0?null:Number(e.value),currency:e.currency||null,properties:o,consent:this.consentState},Array.isArray(e.items)&&e.items.length?{items:e.items.slice(0,50)}:{});this.hashing++,S(u?null:e).then(n=>{this.hashing--,n&&(this.person=n.hash,this.personKind=n.kind,p("ph",n.hash),p("pk",n.kind)),l.person_hash=u?null:this.person,l.person_kind=u||!this.person?null:this.personKind,this.queue.push(l),this.urgent&&!this.hashing?(this.urgent=!1,this.flush()):this.timer||(this.timer=setTimeout(()=>this.flush(),400))})}async suggest(t={}){var a;let e=new URLSearchParams({key:this.key}),o=this.consentState==="denied"?null:m("vid");o&&e.set("visitor",o),t.product&&e.set("product",t.product),(a=t.exclude)!=null&&a.length&&e.set("exclude",t.exclude.join(",")),t.limit&&e.set("limit",String(t.limit));try{let s=await fetch(`${this.api}/api/v1/suggest?${e}`,{mode:"cors",credentials:"omit"});return s.ok?await s.json():{suggestions:[],recentlyViewed:[]}}catch(s){return{suggestions:[],recentlyViewed:[]}}}identify(t){S(t).then(e=>{e&&this.consentState!=="denied"&&(this.person=e.hash,this.personKind=e.kind,p("ph",e.hash),p("pk",e.kind))})}consent(t){if(this.consentState=t==="granted"||t==="denied"?t:"unknown",p("consent",this.consentState),this.consentState==="denied"){for(let e of["vid","ph","pk","clicks","visit"])p(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),o=["q","s","search","query","keyword"].map(s=>e.get(s)).find(s=>s&&s.trim());o&&this.track("search",{query:o.trim().slice(0,200)});let a=B();a&&this.track("view_content",{items:[a.item],value:a.item.price,currency:a.currency})}wire(){if(this.wired)return;this.wired=!0,this.page();for(let e of["pushState","replaceState"]){let o=history[e];typeof o=="function"&&(history[e]=function(...a){let s=o.apply(this,a);return setTimeout(()=>f==null?void 0:f.page(),0),s})}window.addEventListener("popstate",()=>this.page());let t=typeof WeakSet=="function"?new WeakSet:null;document.addEventListener("focusin",e=>{var a,s;let o=(s=(a=e.target)==null?void 0:a.closest)==null?void 0:s.call(a,"form");!o||!t||t.has(o)||(t.add(o),this.track("form_start",{form:(o.getAttribute("name")||o.id||"").slice(0,60)||void 0}))}),document.addEventListener("submit",e=>{let o=e.target;if(!o||!o.getAttribute||o.getAttribute("data-optiq")!=="lead")return;let a=o.querySelector('input[type="email"]'),s=o.querySelector('input[type="tel"]');this.track("lead",{form:(o.getAttribute("name")||o.id||"").slice(0,60)||void 0,email:a?a.value:void 0,phone:s?s.value:void 0}),this.flush()}),document.addEventListener("click",e=>{var s,u;let o=(u=(s=e.target)==null?void 0:s.closest)==null?void 0:u.call(s,"a[href]");if(!o)return;let a=Z(o.getAttribute("href")||"");a&&(this.track("contact",{channel:a}),this.flush())},!0),z(e=>this.track("video_progress",e)),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flush()}),window.addEventListener("pagehide",()=>this.flush())}};function z(i){if(typeof WeakMap!="function")return;let t=new WeakMap,e=[],o=n=>{let r=n.getAttribute("data-optiq-video");if(r&&r!=="on")return r.slice(0,120);let c=n.getAttribute("title")||n.getAttribute("aria-label");if(c)return c.slice(0,120);for(let d of[n.currentSrc,n.getAttribute("src"),n.poster]){if(!d||d.indexOf("blob:")===0||d.indexOf("data:")===0)continue;let g=d.split("?")[0].split("#")[0].split("/").filter(Boolean).pop();if(g)try{return decodeURIComponent(g).slice(0,120)}catch(k){return g.slice(0,120)}}return(document.title||"video").slice(0,120)},a=n=>{let r=n.getAttribute("data-optiq-video");return r==="off"?!1:r?!0:!n.loop&&(n.controls||!n.muted)},s=(n,r,c)=>{let d=Number.isFinite(n.duration)&&n.duration>0?Math.round(n.duration):void 0;i({video:o(n),percent:c,seconds:Math.round(r.played),duration:d}),r.sent=r.played},u=n=>typeof HTMLVideoElement!="undefined"&&n.target instanceof HTMLVideoElement?n.target:null;document.addEventListener("play",n=>{let r=u(n);if(!r)return;let c=t.get(r);c||(c={at:r.currentTime,played:0,sent:0,reached:-1,counted:null},t.set(r,c)),c.at=r.currentTime,c.counted===null&&(c.counted=a(r)),c.counted&&(e.indexOf(r)<0&&e.push(r),c.reached<0&&(c.reached=0,s(r,c,0)))},!0),document.addEventListener("timeupdate",n=>{let r=u(n),c=r?t.get(r):void 0;if(!r||!c||!c.counted)return;let d=r.currentTime-c.at;if(d>0&&d<2.5&&(c.played+=d),c.at=r.currentTime,!Number.isFinite(r.duration)||r.duration<=0)return;let g=Math.min(100,Math.floor(r.currentTime/r.duration*4)*25);g>=25&&g>c.reached&&(c.reached=g,s(r,c,g))},!0),document.addEventListener("ended",n=>{let r=u(n),c=r?t.get(r):void 0;!r||!c||!c.counted||c.reached>=100||(c.reached=100,s(r,c,100))},!0);let l=()=>{for(let n of e){let r=t.get(n);r&&r.played-r.sent>=3&&s(n,r,Math.max(0,r.reached))}};document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&l()}),window.addEventListener("pagehide",l)}function F(){let i={};try{for(let t of document.cookie.split(";")){let[e,...o]=t.trim().split("="),a=decodeURIComponent(o.join("=")||"").slice(0,300);a&&(e==="_fbp"?i.fbp=a:e==="_fbc"?i.fbc=a:e==="_ttp"&&(i.ttp=a))}}catch(t){}return i}function B(){var t,e,o;let i=document.querySelectorAll('script[type="application/ld+json"]');for(let a of Array.from(i)){let s;try{s=JSON.parse(a.textContent||"null")}catch(l){continue}let u=[s];for(;u.length;){let l=u.shift();if(Array.isArray(l)){u.push(...l);continue}if(!l||typeof l!="object")continue;let n=l;n["@graph"]&&u.push(n["@graph"]);let r=n["@type"];if(r!=="Product"&&!(Array.isArray(r)&&r.includes("Product")))continue;let c=Array.isArray(n.offers)?n.offers[0]:n.offers,d=String(n.sku||n.productID||n.gtin13||n.mpn||n["@id"]||n.url||n.name||"").slice(0,100);if(!d)continue;let g=typeof n.brand=="string"?n.brand:(t=n.brand)==null?void 0:t.name,k=Number((e=c==null?void 0:c.price)!=null?e:c==null?void 0:c.lowPrice),h={id:d};typeof n.name=="string"&&(h.name=n.name.slice(0,200)),typeof n.category=="string"&&(h.category=n.category.slice(0,120)),g&&(h.brand=String(g).slice(0,120)),Number.isFinite(k)&&(h.price=k);let b=typeof n.image=="string"?n.image:Array.isArray(n.image)?n.image.find($=>typeof $=="string"):(o=n.image)==null?void 0:o.url;typeof b=="string"&&/^https?:\/\//.test(b)&&(h.image=b.slice(0,500));let H=typeof n.url=="string"&&/^https?:\/\//.test(n.url)?n.url:window.location.origin+window.location.pathname;h.url=H.slice(0,500);let j=typeof(c==null?void 0:c.priceCurrency)=="string"?c.priceCurrency.toUpperCase().slice(0,3):void 0;return{item:h,currency:j}}}return null}function Z(i){return/^tel:/i.test(i)?"call":/^mailto:[^?]/i.test(i)?"email":/^https?:\/\/(wa\.me\/\+?[0-9]|api\.whatsapp\.com\/send\/?\?(.*&)?phone=)/i.test(i)?"whatsapp":null}var f=null,E=[];function R(i){return P()?f||(!i||typeof i.key!="string"||!/^pk_[A-Za-z0-9]{20,40}$/.test(i.key)?(console.warn("[optiq] init needs the source's publishable key (pk_...), from the Developer page."),null):(f=new A(i),E.splice(0).forEach(t=>t()),f)):null}var y=i=>{P()&&(f?i(f):E.push(()=>f&&i(f)))},T=(i,t)=>y(e=>e.track(i,t)),C=i=>y(t=>t.identify(i)),I=i=>y(t=>t.consent(i)),M=()=>y(i=>i.page());function V(i){return P()?new Promise(t=>y(e=>void e.suggest(i).then(t))):Promise.resolve({suggestions:[],recentlyViewed:[]})}(function(){if(window.__optiqLoaded)return;window.__optiqLoaded=!0;let i=document.currentScript||document.querySelector('script[src*="/t.js"][data-key]');if(!i)return;let t=(window.optiq&&window.optiq.q||[]).map(s=>Array.prototype.slice.call(s));function e(s,u,l){s==="track"?T(String(u),l||{}):s==="identify"?C(u||{}):s==="consent"?I(u):s==="page"&&M()}let o=(...s)=>e(...s);o.track=(s,u)=>T(s,u),o.suggest=s=>V(s),window.optiq=o;let a=t.filter(s=>s[0]==="consent").pop();R({key:i.getAttribute("data-key")||"",endpoint:i.getAttribute("data-endpoint")||void 0,api:i.getAttribute("data-api")||void 0,consent:a&&(a[1]==="granted"||a[1]==="denied")?a[1]:void 0}),t.forEach(s=>e(...s))})();})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optiqstudio/track",
-  "version": "0.2.0",
+  "version": "0.4.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",