@active-reach/web-sdk 1.0.0 → 1.2.0

package/dist/ecommerce/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * E-Commerce helper methods for the Aegis SDK.
+ *
+ * Provides standardized e-commerce event tracking that maps to the
+ * Active Reach Intelligence data governance pipeline.
+ *
+ * Event names follow the canonical mapper:
+ *   product_viewed      → engagement.product_view
+ *   product_list_viewed → engagement.product_list_view
+ *   cart_item_added     → cart_item_added
+ *   cart_item_removed   → cart_item_removed
+ *   cart_viewed         → cart_viewed
+ *   checkout_started    → checkout_started
+ *   checkout_step       → checkout_step
+ *   order_completed     → transaction.purchase
+ *   order_refunded      → transaction.refund
+ *   coupon_applied      → coupon_applied
+ *   coupon_removed      → coupon_removed
+ *   search_performed    → search_performed
+ *   wishlist_item_added → wishlist_item_added
+ *   promotion_viewed    → promotion_viewed
+ *   promotion_clicked   → promotion_clicked
+ */
+import type { Aegis } from '../core/analytics';
+import type { EcommerceProduct, EcommerceCart, EcommerceCheckout, EcommerceOrder, EcommerceCoupon, EcommerceSearch, EcommerceProductList, EcommerceWishlist, EcommercePromotion } from './types';
+export declare class EcommerceTracker {
+    private aegis;
+    constructor(aegis: Aegis);
+    productViewed(product: EcommerceProduct): void;
+    productListViewed(list: EcommerceProductList): void;
+    searchPerformed(search: EcommerceSearch): void;
+    addToCart(product: EcommerceProduct): void;
+    removeFromCart(product: EcommerceProduct): void;
+    cartViewed(cart: EcommerceCart): void;
+    checkoutStarted(checkout: EcommerceCheckout): void;
+    checkoutStep(step: number, options?: Record<string, unknown>): void;
+    orderCompleted(order: EcommerceOrder): void;
+    orderRefunded(orderId: string, value?: number, products?: EcommerceProduct[]): void;
+    couponApplied(coupon: EcommerceCoupon): void;
+    couponRemoved(coupon: EcommerceCoupon): void;
+    wishlistItemAdded(wishlist: EcommerceWishlist): void;
+    promotionViewed(promo: EcommercePromotion): void;
+    promotionClicked(promo: EcommercePromotion): void;
+}
+export type { EcommerceProduct, EcommerceCart, EcommerceCheckout, EcommerceOrder, EcommerceCoupon, EcommerceSearch, EcommerceProductList, EcommerceWishlist, EcommercePromotion, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/ecommerce/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ecommerce/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAsBjB,qBAAa,gBAAgB;IACf,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAIhC,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAgB9C,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IASnD,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAU9C,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAe1C,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAY/C,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAYrC,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAalD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IASnE,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAgB3C,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAUnF,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAI5C,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAM5C,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAcpD,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAIhD,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;CAGlD;AAED,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/ecommerce/types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * E-Commerce event types following the Active Reach Intelligence spec.
+ * Compatible with Segment/GA4 e-commerce event schemas.
+ */
+export interface EcommerceProduct {
+    product_id: string;
+    sku?: string;
+    name: string;
+    price: number;
+    quantity?: number;
+    currency?: string;
+    category?: string;
+    brand?: string;
+    variant_id?: string;
+    variant_label?: string;
+    image_url?: string;
+    url?: string;
+    position?: number;
+}
+export interface EcommerceCart {
+    cart_id?: string;
+    value: number;
+    currency?: string;
+    products: EcommerceProduct[];
+}
+export interface EcommerceCheckout {
+    checkout_id?: string;
+    value: number;
+    currency?: string;
+    products: EcommerceProduct[];
+    coupon?: string;
+    shipping?: number;
+    tax?: number;
+}
+export interface EcommerceOrder {
+    order_id: string;
+    value: number;
+    revenue?: number;
+    currency?: string;
+    products: EcommerceProduct[];
+    coupon?: string;
+    shipping?: number;
+    tax?: number;
+    discount?: number;
+    payment_method?: string;
+}
+export interface EcommerceCoupon {
+    coupon_id?: string;
+    coupon_code: string;
+    discount_value?: number;
+    discount_type?: 'percentage' | 'fixed';
+    order_id?: string;
+    cart_id?: string;
+}
+export interface EcommerceSearch {
+    query: string;
+    results_count?: number;
+    filters?: Record<string, string | string[]>;
+}
+export interface EcommerceProductList {
+    list_id?: string;
+    list_name?: string;
+    products: EcommerceProduct[];
+    category?: string;
+}
+export interface EcommerceWishlist {
+    wishlist_id?: string;
+    wishlist_name?: string;
+    product: EcommerceProduct;
+}
+export interface EcommercePromotion {
+    promotion_id?: string;
+    name: string;
+    creative?: string;
+    position?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ecommerce/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ecommerce/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/index.d.ts

@@ -20,4 +20,6 @@ export { SdkConfigPoller } from './core/sdk-config-poller';
 export type { SdkConfig, SdkConfigPollerOptions, ConfigChangeCallback } from './core/sdk-config-poller';
 export { AegisWebPush } from './push/AegisWebPush';
 export type { AegisWebPushConfig, AegisAPIClient, ContactIdentity, PushEventTracker, } from './push/AegisWebPush';
+export { EcommerceTracker } from './ecommerce';
+export type { EcommerceProduct, EcommerceCart, EcommerceCheckout, EcommerceOrder, EcommerceCoupon, EcommerceSearch, EcommerceProductList, EcommerceWishlist, EcommercePromotion, } from './ecommerce';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,QAAA,MAAM,KAAK,OAAc,CAAC;AAE1B,eAAe,KAAK,CAAC;AAErB,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAExG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,QAAA,MAAM,KAAK,OAAc,CAAC;AAE1B,eAAe,KAAK,CAAC;AAErB,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAExG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
-import { l as logger, A as Aegis } from "./analytics-B11keZ55.mjs";
+import { l as logger, A as Aegis } from "./analytics-CNtfsb7E.mjs";
+import { E } from "./analytics-CNtfsb7E.mjs";
 import { AegisWebPush } from "./push/AegisWebPush.js";
 function debounce(func, wait) {
   let timeoutId = null;
@@ -2023,6 +2024,73 @@ class AegisPlacementManager {
     return "#000000";
   }
   sanitizeHTML(html) {
+    const purify = window.DOMPurify;
+    if (purify == null ? void 0 : purify.sanitize) {
+      return purify.sanitize(html, {
+        ALLOWED_TAGS: [
+          "a",
+          "b",
+          "br",
+          "div",
+          "em",
+          "h1",
+          "h2",
+          "h3",
+          "h4",
+          "h5",
+          "h6",
+          "i",
+          "img",
+          "li",
+          "ol",
+          "p",
+          "span",
+          "strong",
+          "u",
+          "ul",
+          "table",
+          "thead",
+          "tbody",
+          "tr",
+          "th",
+          "td",
+          "blockquote",
+          "hr",
+          "figure",
+          "figcaption",
+          "picture",
+          "source",
+          "video",
+          "section",
+          "article"
+        ],
+        ALLOWED_ATTR: [
+          "href",
+          "target",
+          "rel",
+          "src",
+          "alt",
+          "width",
+          "height",
+          "class",
+          "id",
+          "style",
+          "title",
+          "loading",
+          "srcset",
+          "sizes",
+          "type",
+          "media",
+          "controls",
+          "poster"
+        ],
+        ALLOW_DATA_ATTR: false
+      });
+    }
+    this.log(
+      'DOMPurify not found — falling back to built-in sanitizer. For full HTML placement support, add <script src="https://cdnjs.cloudflare.com/ajax/libs/dompurify/3.2.4/purify.min.js"><\/script>',
+      false
+    );
     const tempDiv = document.createElement("div");
     tempDiv.textContent = html;
     return tempDiv.innerHTML;
@@ -4286,6 +4354,7 @@ export {
   AegisPlacementManager,
   AegisWebPush,
   AegisWidgetManager,
+  E as EcommerceTracker,
   SdkConfigPoller,
   TriggerEngine,
   debounce,