@g2crowd/buyer-intent-provider-sdk 0.2.0 → 0.4.0

package/src/browser/components/tracker.js

@@ -0,0 +1,105 @@
+import React from 'react';
+
+function buildViewAttrs({
+  productId,
+  productIds,
+  categoryId,
+  tag,
+  sourceLocation,
+  context,
+  origin,
+  activityEndpoint,
+  userType,
+  distinctId,
+}) {
+  const payload = { sourceLocation, context };
+  const attrs = {
+    'data-buyer-intent': JSON.stringify(payload),
+    'data-origin': origin,
+    'data-activity-endpoint': activityEndpoint,
+    'data-user-type': userType,
+    'data-distinct-id': distinctId,
+  };
+
+  if (tag) attrs.tag = tag;
+  if (sourceLocation) attrs['source-location'] = sourceLocation;
+  if (productId != null) attrs['product-id'] = String(productId);
+  if (productIds) attrs['product-ids'] = JSON.stringify(productIds);
+  if (categoryId != null) attrs['category-id'] = String(categoryId);
+
+  return attrs;
+}
+
+function buildClickAttrs({
+  eventName,
+  productId,
+  productIds,
+  categoryId,
+  sourceLocation,
+  context,
+  origin,
+  activityEndpoint,
+  userType,
+  distinctId,
+}) {
+  const payload = { sourceLocation, context };
+  const attrs = {
+    'data-buyer-intent': JSON.stringify(payload),
+    'data-origin': origin,
+    'data-activity-endpoint': activityEndpoint,
+    'data-user-type': userType,
+    'data-distinct-id': distinctId,
+  };
+
+  if (eventName) attrs['event-name'] = eventName;
+  if (productId != null) attrs['product-id'] = String(productId);
+  if (productIds) attrs['product-ids'] = JSON.stringify(productIds);
+  if (categoryId != null) attrs['category-id'] = String(categoryId);
+
+  return attrs;
+}
+
+export function SessionProvider({
+  origin,
+  activityEndpoint,
+  userType,
+  distinctId,
+  children,
+}) {
+  const attrs = {};
+  if (origin) attrs.origin = origin;
+  if (activityEndpoint) attrs['activity-endpoint'] = activityEndpoint;
+  if (userType) attrs['user-type'] = userType;
+  if (distinctId) attrs['distinct-id'] = distinctId;
+  return React.createElement('buyer-intent-session', attrs, children);
+}
+
+export function SubjectTracker({
+  productId,
+  categoryId,
+  productIds,
+  categoryIds,
+}) {
+  const attrs = {};
+  if (productId != null) attrs['product-id'] = String(productId);
+  if (categoryId != null) attrs['category-id'] = String(categoryId);
+  if (productIds) attrs['product-ids'] = JSON.stringify(productIds);
+  if (categoryIds) attrs['category-ids'] = JSON.stringify(categoryIds);
+  return React.createElement('buyer-intent-subject', attrs);
+}
+
+export function ViewTracker({ children, ...rest }) {
+  return React.createElement(
+    'buyer-intent-view',
+    buildViewAttrs(rest),
+    children
+  );
+}
+
+export function ClickTracker({ children, ...rest }) {
+  return React.createElement(
+    'buyer-intent-click',
+    buildClickAttrs(rest),
+    children
+  );
+}

package/src/browser/dom.js

@@ -0,0 +1,184 @@
+function parseJson(value) {
+  if (!value) {
+    return undefined;
+  }
+
+  try {
+    return JSON.parse(value);
+  } catch (_error) {
+    return undefined;
+  }
+}
+
+function parseArray(value) {
+  if (!value) {
+    return undefined;
+  }
+
+  const parsed = parseJson(value);
+  if (Array.isArray(parsed)) {
+    return parsed;
+  }
+
+  if (typeof value === 'string') {
+    return value
+      .split(',')
+      .map((entry) => entry.trim())
+      .filter(Boolean);
+  }
+
+  return undefined;
+}
+
+function readTagElement(element) {
+  if (!element) {
+    return undefined;
+  }
+
+  if (element.tagName === 'SCRIPT') {
+    const parsed =
+      parseJson(element.textContent || '') ||
+      parseJson(element.getAttribute('data-buyer-intent'));
+    if (parsed && typeof parsed === 'object') {
+      return parsed;
+    }
+  }
+
+  const dataJson = parseJson(element.getAttribute('data-buyer-intent'));
+  if (dataJson && typeof dataJson === 'object') {
+    return dataJson;
+  }
+
+  const dataset = element.dataset || {};
+  return {
+    productIds: parseArray(dataset.productIds),
+    categoryIds: parseArray(dataset.categoryIds),
+    tag: dataset.tag,
+    sourceLocation: dataset.sourceLocation,
+    context: parseJson(dataset.context),
+  };
+}
+
+export function readTags(elements) {
+  if (typeof document === 'undefined') {
+    return [];
+  }
+
+  const found = elements || new Set();
+  const legacy = document.getElementById('buyer-intent-tags');
+  if (legacy) {
+    found.add(legacy);
+  }
+
+  document.querySelectorAll('[data-buyer-intent]').forEach((element) => {
+    found.add(element);
+  });
+
+  return Array.from(found)
+    .map((element) => ({ element, tag: readTagElement(element) }))
+    .filter((entry) => entry.tag && typeof entry.tag === 'object');
+}
+
+export function readElementConfig(element) {
+  if (!element || !element.dataset) {
+    return {};
+  }
+
+  const { origin, userType, distinctId, activityEndpoint } = element.dataset;
+
+  return { origin, userType, distinctId, activityEndpoint };
+}
+
+export function resolveEventName(element, fallback) {
+  if (element && element.dataset && element.dataset.eventName) {
+    return element.dataset.eventName;
+  }
+
+  return fallback;
+}
+
+function parseIds(raw) {
+  if (!raw) return [];
+  try {
+    const parsed = JSON.parse(raw);
+    if (Array.isArray(parsed)) return parsed.map(Number);
+  } catch (_e) {}
+  return raw.split(',').map((s) => Number(s.trim())).filter((n) => !Number.isNaN(n));
+}
+
+export function readSessionConfig(element) {
+  if (!element || typeof element.closest !== 'function') {
+    return {};
+  }
+
+  const session = element.closest('buyer-intent-session');
+  if (!session) {
+    return {};
+  }
+
+  return {
+    origin: session.getAttribute('origin') || undefined,
+    activityEndpoint: session.getAttribute('activity-endpoint') || undefined,
+    userType: session.getAttribute('user-type') || undefined,
+    distinctId: session.getAttribute('distinct-id') || undefined,
+  };
+}
+
+export function collectSubjectIds(viewElement) {
+  if (!viewElement || typeof viewElement.querySelectorAll !== 'function') {
+    return { productIds: [], categoryIds: [] };
+  }
+
+  const subjects = viewElement.querySelectorAll('buyer-intent-subject');
+  const productIds = [];
+  const categoryIds = [];
+
+  for (const subject of subjects) {
+    const pids = subject.getAttribute('product-ids');
+    const pid = subject.getAttribute('product-id');
+    if (pids) {
+      productIds.push(...parseIds(pids));
+    } else if (pid) {
+      productIds.push(Number(pid));
+    }
+
+    const cids = subject.getAttribute('category-ids');
+    const cid = subject.getAttribute('category-id');
+    if (cids) {
+      categoryIds.push(...parseIds(cids));
+    } else if (cid) {
+      categoryIds.push(Number(cid));
+    }
+  }
+
+  return { productIds, categoryIds };
+}
+
+export function readViewContext(clickElement) {
+  if (!clickElement || typeof clickElement.closest !== 'function') {
+    return {};
+  }
+
+  const view = clickElement.closest('buyer-intent-view');
+  if (!view) {
+    return {};
+  }
+
+  const viewData = readTagElement(view) || {};
+  const subjectIds = collectSubjectIds(view);
+
+  const productIds = [
+    ...(viewData.productIds || []),
+    ...subjectIds.productIds,
+  ];
+  const categoryIds = [
+    ...(viewData.categoryIds || []),
+    ...subjectIds.categoryIds,
+  ];
+
+  return {
+    ...viewData,
+    productIds: productIds.length ? [...new Set(productIds)] : undefined,
+    categoryIds: categoryIds.length ? [...new Set(categoryIds)] : undefined,
+  };
+}

package/src/browser/elements/base.js

@@ -0,0 +1,124 @@
+import { ensureSDK } from '../sdk.js';
+
+const BaseHTMLElement =
+  typeof HTMLElement !== 'undefined' ? HTMLElement : class {};
+
+function parseIds(raw) {
+  if (!raw) return undefined;
+  try {
+    const parsed = JSON.parse(raw);
+    if (Array.isArray(parsed)) return parsed;
+  } catch (_e) {}
+  return raw.split(',').map((s) => Number(s.trim()));
+}
+
+function readIntentData(element) {
+  const data = {};
+  const productId = element.getAttribute('product-id');
+  const productIds = element.getAttribute('product-ids');
+  const categoryId = element.getAttribute('category-id');
+
+  if (productIds) {
+    data.productIds = parseIds(productIds);
+  } else if (productId) {
+    data.productIds = [Number(productId)];
+  }
+
+  if (categoryId) {
+    data.categoryIds = [Number(categoryId)];
+  }
+
+  const tag = element.getAttribute('tag');
+  if (tag) {
+    data.tag = tag;
+  }
+
+  const sourceLocation = element.getAttribute('source-location');
+  if (sourceLocation) {
+    data.sourceLocation = sourceLocation;
+  }
+
+  const eventName = element.getAttribute('event-name');
+  if (eventName) {
+    element.dataset.eventName = eventName;
+  }
+
+  return data;
+}
+
+function mergeIntentData(element, patch) {
+  let existing = {};
+  try {
+    existing = JSON.parse(element.getAttribute('data-buyer-intent') || '{}');
+  } catch (_e) {
+    existing = {};
+  }
+  const merged = { ...existing, ...patch };
+  element.setAttribute('data-buyer-intent', JSON.stringify(merged));
+}
+
+function defineElement(tagName, ElementClass) {
+  if (typeof customElements !== 'undefined' && !customElements.get(tagName)) {
+    customElements.define(tagName, ElementClass);
+  }
+}
+
+class BuyerIntentSessionElement extends BaseHTMLElement {
+  connectedCallback() {
+    this.style.display = 'contents';
+  }
+}
+
+class BuyerIntentSubjectElement extends BaseHTMLElement {
+  connectedCallback() {
+    this.style.display = 'none';
+  }
+}
+
+class BuyerIntentViewElement extends BaseHTMLElement {
+  connectedCallback() {
+    ensureSDK();
+    mergeIntentData(this, readIntentData(this));
+    this.dataset.trigger = 'view';
+    queueMicrotask(() => {
+      this.dispatchEvent(
+        new CustomEvent('buyerintent:view', { bubbles: true })
+      );
+    });
+  }
+}
+
+class BuyerIntentClickElement extends BaseHTMLElement {
+  connectedCallback() {
+    ensureSDK();
+    mergeIntentData(this, readIntentData(this));
+    this.dataset.trigger = 'click';
+    this._handleClick = () => {
+      this.dispatchEvent(
+        new CustomEvent('buyerintent:click', { bubbles: true })
+      );
+    };
+    this.addEventListener('click', this._handleClick);
+  }
+
+  disconnectedCallback() {
+    if (this._handleClick) {
+      this.removeEventListener('click', this._handleClick);
+      this._handleClick = null;
+    }
+  }
+}
+
+defineElement('buyer-intent-session', BuyerIntentSessionElement);
+defineElement('buyer-intent-subject', BuyerIntentSubjectElement);
+defineElement('buyer-intent-view', BuyerIntentViewElement);
+defineElement('buyer-intent-click', BuyerIntentClickElement);
+
+export {
+  BuyerIntentSessionElement,
+  BuyerIntentSubjectElement,
+  BuyerIntentViewElement,
+  BuyerIntentClickElement,
+  mergeIntentData,
+  defineElement,
+};

package/src/browser/elements/index.js

@@ -0,0 +1,6 @@
+export {
+  BuyerIntentSessionElement,
+  BuyerIntentSubjectElement,
+  BuyerIntentViewElement,
+  BuyerIntentClickElement,
+} from './base.js';

package/src/browser/identity.js

@@ -0,0 +1,67 @@
+const STORAGE_KEY = 'buyer_intent_distinct_id';
+
+function generateId() {
+  if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+
+  return `bi-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
+
+function read() {
+  if (typeof window === 'undefined') {
+    return null;
+  }
+
+  try {
+    return window.localStorage.getItem(STORAGE_KEY);
+  } catch (_error) {
+    return null;
+  }
+}
+
+function store(value) {
+  if (typeof window === 'undefined') {
+    return;
+  }
+
+  try {
+    window.localStorage.setItem(STORAGE_KEY, value);
+  } catch (_error) {
+    return;
+  }
+}
+
+export function createIdentityManager() {
+  let distinctId = null;
+
+  function ensure() {
+    if (distinctId) {
+      return distinctId;
+    }
+
+    const stored = read();
+    if (stored) {
+      distinctId = stored;
+      return stored;
+    }
+
+    const generated = generateId();
+    distinctId = generated;
+    store(generated);
+    return generated;
+  }
+
+  function set(value) {
+    if (value) {
+      distinctId = value;
+      store(value);
+    }
+  }
+
+  function get() {
+    return distinctId;
+  }
+
+  return { ensure, set, get };
+}

package/src/browser/index.js

@@ -0,0 +1,8 @@
+export {
+  BuyerIntentSessionElement,
+  BuyerIntentSubjectElement,
+  BuyerIntentViewElement,
+  BuyerIntentClickElement,
+} from './elements/index.js';
+
+export { createBuyerIntentSDK, buyerIntent } from './sdk.js';