@replohq/sdk 1.14.1 → 1.16.0

package/_vendor/schemas/generated/consent.d.ts

@@ -1,4 +1,4 @@
-export type ReploScriptType = "GA4" | "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "Cookiebot" | "snippet" | "custom" | "consentPlatform";
+export type ReploScriptType = "GA4" | "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "X" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "Cookiebot" | "snippet" | "custom" | "consentPlatform";
 export type ConsentCategory = "necessary" | "analytics" | "marketing" | "preferences" | "sale_of_data";
 export type ConsentMode = "off" | "simple" | "per-category";
 export type ScriptTagDescriptor = {
@@ -12,10 +12,22 @@ export type ScriptTagDescriptor = {
     body: string;
     module?: boolean;
 };
+export type XPixelEvents = {
+    pageView?: string;
+    productViewed?: string;
+    addToCart?: string;
+    startCheckout?: string;
+    purchase?: string;
+};
 export type ReploScriptEntry = {
     type: "GA4" | "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge";
     identifier: string;
     requiredConsent?: ConsentCategory[];
+} | {
+    type: "X";
+    identifier: string;
+    events?: Partial<XPixelEvents>;
+    requiredConsent?: ConsentCategory[];
 } | {
     type: "Cookiebot";
     identifier: string;

package/_vendor/schemas/loaderKeys.mjs

@@ -1,6 +1,7 @@
 import '../../chunk-UJCSKKID.mjs';
 
 var DATA_LOADER_KEYS = {
+  SHOPIFY_INTEGRATION_DETAILS: "shopify_storefront.integration_details",
   SHOPIFY_PRODUCT: "shopify_storefront.product",
   SHOPIFY_COLLECTION: "shopify_storefront.collection",
   SHOPIFY_COLLECTION_PRODUCTS: "shopify_storefront.collection_products",

package/analytics/analytics-provider.d.ts

@@ -4,6 +4,8 @@ import type { AnalyticsSink } from "./analytics-sink";
 export declare function AnalyticsProvider({ children, checkoutProvider, }: React.PropsWithChildren<{
     checkoutProvider?: CheckoutProvider;
 }>): import("react/jsx-runtime").JSX.Element;
+/** Register one stable, consent-aware sink beneath ReploProvider. */
+export declare function useAnalyticsSink(sink: AnalyticsSink): void;
 /**
  * Returns the AnalyticsSink from the nearest AnalyticsProvider.
  * Throws if used outside of an AnalyticsProvider.

package/analytics/analytics-provider.js

@@ -1,6 +1,14 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
-import { createContext, useContext, useEffect, useMemo, useRef } from "react";
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useEffect,
+  useMemo,
+  useRef,
+  useState
+} from "react";
 import { useConsent } from "../consent/consent-store";
 import { useRegisteredScripts } from "../consent/script-registration-store";
 import { combineSinks } from "./combine-sinks";
@@ -13,9 +21,18 @@ function AnalyticsProvider({
 }) {
   const consent = useConsent();
   const registeredScripts = useRegisteredScripts();
+  const [additionalSinks, setAdditionalSinks] = useState([]);
+  const registerSink = useCallback((sink) => {
+    setAdditionalSinks((current) => [...current, sink]);
+    return () => {
+      setAdditionalSinks((current) => {
+        return current.filter((registered) => registered !== sink);
+      });
+    };
+  }, []);
   const analytics = useMemo(() => {
-    return combineSinks(
-      getAnalyticsSinks({
+    return combineSinks([
+      ...getAnalyticsSinks({
         consent: {
           cmp: consent.cmp,
           mode: consent.mode,
@@ -24,15 +41,17 @@ function AnalyticsProvider({
         },
         registeredScripts,
         checkoutProvider
-      })
-    );
+      }),
+      ...additionalSinks
+    ]);
   }, [
     consent.cmp,
     consent.mode,
     consent.categories,
     consent.decidedAt,
     registeredScripts,
-    checkoutProvider
+    checkoutProvider,
+    additionalSinks
   ]);
   const analyticsRef = useRef(analytics);
   analyticsRef.current = analytics;
@@ -51,7 +70,17 @@ function AnalyticsProvider({
       navigationTracker.current?.cleanup();
     };
   }, []);
-  return /* @__PURE__ */ jsx(AnalyticsContext.Provider, { value: { analytics }, children });
+  return /* @__PURE__ */ jsx(AnalyticsContext.Provider, { value: { analytics, registerSink }, children });
+}
+function useAnalyticsSink(sink) {
+  const context = useContext(AnalyticsContext);
+  if (!context) {
+    throw new AnalyticsContextError({
+      message: "useAnalyticsSink must be used within <AnalyticsProvider>"
+    });
+  }
+  const registerSink = context.registerSink;
+  useEffect(() => registerSink(sink), [registerSink, sink]);
 }
 class AnalyticsContextError extends Error {
   constructor({ message }) {
@@ -74,5 +103,6 @@ function useAnalyticsOptional() {
 export {
   AnalyticsProvider,
   useAnalytics,
-  useAnalyticsOptional
+  useAnalyticsOptional,
+  useAnalyticsSink
 };

package/analytics/analytics-sink.d.ts

@@ -13,7 +13,16 @@ export type PurchasePayload = {
     currency: string;
     data: Record<string, any>;
 };
+export type AnalyticsProperty = string | number | boolean | null | AnalyticsProperty[] | {
+    [key: string]: AnalyticsProperty;
+};
+export interface CustomEventPayload {
+    event: string;
+    properties?: Record<string, AnalyticsProperty>;
+}
 export interface AnalyticsSink {
+    /** Explicit business goals; sinks without custom-event support may omit this. */
+    customEvent?(payload: CustomEventPayload): Promise<void>;
     pageView(metadata?: PageMetadata): Promise<void>;
     purchase(payload: PurchasePayload): Promise<void>;
     click(payload: DataPayload): Promise<void>;

package/analytics/combine-sinks.js

@@ -12,7 +12,7 @@ function combineSinks(sinks) {
       sinks.map(async (sink) => {
         try {
           const sinkMethod = sink[method];
-          await sinkMethod.apply(sink, args);
+          await sinkMethod?.apply(sink, args);
         } catch {
           if (typeof window !== "undefined") {
             console.warn("[analytics] sink error", { method });
@@ -22,6 +22,7 @@ function combineSinks(sinks) {
     );
   };
   return {
+    customEvent: (...args) => broadcast("customEvent", ...args),
     pageView: (...args) => broadcast("pageView", ...args),
     purchase: (...args) => broadcast("purchase", ...args),
     click: (...args) => broadcast("click", ...args),

package/analytics/get-analytics-sinks.js

@@ -11,6 +11,7 @@ import { ReploSink } from "./sinks/replo-sink";
 import { SnapchatSink } from "./sinks/snapchat-sink";
 import { TikTokSink } from "./sinks/tiktok-sink";
 import { WindowSink } from "./sinks/window-sink";
+import { XSink } from "./sinks/x-sink";
 import { gateShopifyOwnedFunnelEvents } from "./utils/shopify-funnel-gate";
 const PROVIDER_SINK_FACTORIES = {
   GA4: () => new GA4Sink(),
@@ -26,6 +27,14 @@ const SNIPPET_PROVIDER_SINK_FACTORIES = {
   [snippetScriptId("Elevar")]: () => new ElevarSink()
 };
 function findSinkFactory(script) {
+  if (script.type === "X") {
+    return () => {
+      return new XSink({
+        pixelId: script.pixelId,
+        events: script.events
+      });
+    };
+  }
   if (script.type === "snippet") {
     return SNIPPET_PROVIDER_SINK_FACTORIES[script.id] ?? null;
   }

package/analytics/sinks/intelligems-sink.d.ts

@@ -0,0 +1,29 @@
+import type { AnalyticsSink, CustomEventPayload, DataPayload, PurchasePayload } from "../analytics-sink";
+import type { PageMetadata } from "../utils/navigation-tracker";
+export type IntelligemsEventMappings = {
+    [Method in Exclude<keyof AnalyticsSink, "customEvent">]?: (...args: Parameters<AnalyticsSink[Method]>) => CustomEventPayload | null;
+};
+/**
+ * Sends explicitly selected custom goals through the installed Intelligems SDK.
+ * Native page views, experiment assignment, and order attribution remain owned
+ * by useIgTrack and Shopify; duplicating them as custom events changes reports.
+ */
+export declare class IntelligemsSink implements AnalyticsSink {
+    private readonly options;
+    constructor(options: {
+        /** Read live SDK readiness; do not accept events before assignment resolves. */
+        isReady: () => boolean;
+        events?: IntelligemsEventMappings;
+    });
+    customEvent(payload: CustomEventPayload): Promise<void>;
+    private send;
+    pageView(metadata?: PageMetadata): Promise<void>;
+    purchase(payload: PurchasePayload): Promise<void>;
+    click(payload: DataPayload): Promise<void>;
+    productViewed(payload: DataPayload): Promise<void>;
+    addToCart(payload: DataPayload): Promise<void>;
+    removeFromCart(payload: DataPayload): Promise<void>;
+    viewCart(payload: DataPayload): Promise<void>;
+    startCheckout(payload: DataPayload): Promise<void>;
+    viewCollection(payload: DataPayload): Promise<void>;
+}

package/analytics/sinks/intelligems-sink.js

@@ -0,0 +1,68 @@
+"use client";
+import { consentStore, isConsentAllowed } from "../../consent/consent-store";
+class IntelligemsSink {
+  constructor(options) {
+    this.options = options;
+  }
+  async customEvent(payload) {
+    if (typeof window === "undefined" || !this.options.isReady()) {
+      return;
+    }
+    if (!isConsentAllowed({
+      state: consentStore.getSnapshot(),
+      requiredConsent: ["analytics"]
+    })) {
+      return;
+    }
+    if (!payload.event.trim() || /[,']/.test(payload.event) || payload.event !== payload.event.trim()) {
+      throw new IntelligemsEventNameError(
+        "Intelligems event names must be nonempty, trimmed, and contain no commas or single quotes"
+      );
+    }
+    if (!("igEvents" in window)) {
+      return;
+    }
+    const transport = window.igEvents;
+    if (!transport || typeof transport !== "object" || Array.isArray(transport) || !("push" in transport) || typeof transport.push !== "function") {
+      return;
+    }
+    await transport.push(payload);
+  }
+  async send(payload) {
+    if (payload) {
+      await this.customEvent(payload);
+    }
+  }
+  async pageView(metadata) {
+    await this.send(this.options.events?.pageView?.(metadata));
+  }
+  async purchase(payload) {
+    await this.send(this.options.events?.purchase?.(payload));
+  }
+  async click(payload) {
+    await this.send(this.options.events?.click?.(payload));
+  }
+  async productViewed(payload) {
+    await this.send(this.options.events?.productViewed?.(payload));
+  }
+  async addToCart(payload) {
+    await this.send(this.options.events?.addToCart?.(payload));
+  }
+  async removeFromCart(payload) {
+    await this.send(this.options.events?.removeFromCart?.(payload));
+  }
+  async viewCart(payload) {
+    await this.send(this.options.events?.viewCart?.(payload));
+  }
+  async startCheckout(payload) {
+    await this.send(this.options.events?.startCheckout?.(payload));
+  }
+  async viewCollection(payload) {
+    await this.send(this.options.events?.viewCollection?.(payload));
+  }
+}
+class IntelligemsEventNameError extends Error {
+}
+export {
+  IntelligemsSink
+};

package/analytics/sinks/x-sink.d.ts

@@ -0,0 +1,32 @@
+import type { XPixelEvents } from "../../_vendor/schemas/generated/consent";
+import type { AnalyticsSink, DataPayload, PurchasePayload } from "../analytics-sink";
+import type { PageMetadata } from "../utils/navigation-tracker";
+declare global {
+    interface Window {
+        twq?: (command: "config" | "event", ...args: unknown[]) => void;
+    }
+}
+/**
+ * Sends storefront events to X as the conversion events the merchant created
+ * in X Ads Events Manager. X has no named events in code, so an event without
+ * a mapped ID sends nothing. The consent-gated base code's `twq('config')`
+ * already records the site visit and landing page view on load.
+ */
+export declare class XSink implements AnalyticsSink {
+    private readonly events;
+    private send;
+    constructor({ pixelId, events }: {
+        pixelId: string;
+        events: XPixelEvents;
+    });
+    private track;
+    pageView(metadata: PageMetadata | undefined): Promise<void>;
+    purchase({ amount, currency, data }: PurchasePayload): Promise<void>;
+    click(): Promise<void>;
+    productViewed({ data }: DataPayload): Promise<void>;
+    addToCart({ data }: DataPayload): Promise<void>;
+    removeFromCart(): Promise<void>;
+    viewCart(): Promise<void>;
+    startCheckout({ data }: DataPayload): Promise<void>;
+    viewCollection(): Promise<void>;
+}

package/analytics/sinks/x-sink.js

@@ -0,0 +1,126 @@
+import { filterUndefined } from "../../_vendor/replo-utils/lib/object.mjs";
+import { z } from "zod";
+import { isXEventIdForPixel } from "../../consent/script-snippets";
+import { legacyResourceId } from "../utils/analytics-products";
+import { createEventQueue } from "../utils/analytics-utils";
+const analyticsRecordSchema = z.record(z.string(), z.unknown());
+const nonEmptyStringSchema = z.union([
+  z.string().min(1),
+  z.number().finite().transform(String)
+]);
+const finiteNumberSchema = z.union([
+  z.number().finite(),
+  z.string().trim().min(1).transform(Number).pipe(z.number().finite())
+]);
+function parseRecord(value) {
+  const result = analyticsRecordSchema.safeParse(value);
+  return result.success ? result.data : {};
+}
+function parseString(value) {
+  const result = nonEmptyStringSchema.safeParse(value);
+  return result.success ? result.data : void 0;
+}
+function parseNumber(value) {
+  const result = finiteNumberSchema.safeParse(value);
+  return result.success ? result.data : void 0;
+}
+function mapContent(value, defaultQuantity) {
+  const line = parseRecord(value);
+  const variant = parseRecord(line.variant);
+  const product = parseRecord(variant.product);
+  const productId = parseString(line.productId) ?? parseString(product.id);
+  if (!productId) {
+    return null;
+  }
+  return filterUndefined({
+    content_id: legacyResourceId(productId),
+    content_name: parseString(line.productTitle) ?? parseString(product.title) ?? parseString(line.title),
+    content_price: parseNumber(line.price) ?? parseNumber(parseRecord(variant.price).amount),
+    num_items: parseNumber(line.quantity) ?? defaultQuantity
+  });
+}
+function mapContents(lines) {
+  const result = z.array(z.unknown()).safeParse(lines);
+  if (!result.success) {
+    return void 0;
+  }
+  const contents = result.data.map((line) => mapContent(line, void 0)).filter((content) => content !== null);
+  return contents.length > 0 ? contents : void 0;
+}
+function lineValue(content) {
+  if (content?.content_price === void 0) {
+    return void 0;
+  }
+  return content.content_price * (content.num_items ?? 1);
+}
+class XSink {
+  events;
+  send = createEventQueue(
+    () => typeof window !== "undefined" && Boolean(window.twq),
+    (eventId, parameters) => window.twq?.("event", eventId, parameters),
+    "X"
+  );
+  constructor({ pixelId, events }) {
+    this.events = Object.fromEntries(
+      Object.entries(events).flatMap(([event, eventId]) => {
+        const trimmed = eventId?.trim();
+        return trimmed && isXEventIdForPixel({ eventId: trimmed, pixelId }) ? [[event, trimmed]] : [];
+      })
+    );
+  }
+  track(event, parameters) {
+    const eventId = this.events[event];
+    if (eventId) {
+      this.send(eventId, filterUndefined(parameters));
+    }
+  }
+  async pageView(metadata) {
+    if (metadata?.navigationType === "initial") {
+      return;
+    }
+    this.track("pageView", {});
+  }
+  async purchase({ amount, currency, data }) {
+    this.track("purchase", {
+      value: amount,
+      currency,
+      conversion_id: parseString(data.order_id) ?? parseString(data.orderId) ?? parseString(data.id),
+      contents: mapContents(data.lineItems)
+    });
+  }
+  async click() {
+  }
+  async productViewed({ data }) {
+    const content = mapContent(data, 1);
+    this.track("productViewed", {
+      value: lineValue(content),
+      currency: parseString(data.currency),
+      contents: content ? [content] : void 0
+    });
+  }
+  async addToCart({ data }) {
+    const content = mapContent(data, 1);
+    this.track("addToCart", {
+      value: lineValue(content),
+      currency: parseString(data.currency),
+      contents: content ? [content] : void 0
+    });
+  }
+  async removeFromCart() {
+  }
+  async viewCart() {
+  }
+  async startCheckout({ data }) {
+    const totalPrice = parseRecord(data.totalPrice);
+    this.track("startCheckout", {
+      value: parseNumber(totalPrice.amount),
+      currency: parseString(data.currencyCode) ?? parseString(totalPrice.currencyCode),
+      contents: mapContents(data.lineItems)
+    });
+  }
+  async viewCollection() {
+  }
+}
+export {
+  XSink
+};

package/cart/buy-now-action.d.ts

@@ -28,6 +28,10 @@ export declare function buyNowWithRecoveryAction(input: {
         properties: CartLineAttribute[];
     }[];
     discountCodes: string[];
+    attributes?: {
+        key: string;
+        value: string;
+    }[];
     pageUrl: string;
 }): Promise<{
     result: "created";

package/cart/buy-now-action.js

@@ -122,7 +122,8 @@ async function buyNowWithRecoveryAction(input) {
     lines: cartLines,
     skipStoringCart: true,
     country: input.country,
-    discountCodes: discountCodes.length > 0 ? discountCodes : void 0
+    discountCodes: discountCodes.length > 0 ? discountCodes : void 0,
+    attributes: input.attributes
   });
   if (!cart?.checkoutUrl) {
     throw new BuyNowCartCreationError({

package/cart/cart-actions.d.ts

@@ -32,6 +32,10 @@ export declare function createCartAction(options?: {
     lines?: CartLinePayload[];
     skipStoringCart?: boolean;
     discountCodes?: string[];
+    attributes?: {
+        key: string;
+        value: string;
+    }[];
     country?: StorefrontCountryCode;
 }): Promise<Cart | null>;
 /**

package/cart/cart-actions.js

@@ -65,6 +65,7 @@ async function createCartAction(options) {
     lines,
     skipStoringCart = false,
     discountCodes,
+    attributes,
     country
   } = options ?? {};
   const checkoutProvider = await getCheckoutProvider();
@@ -72,6 +73,7 @@ async function createCartAction(options) {
   const cart = await cartGateway.createCart({
     lines,
     discountCodes,
+    attributes,
     buyerIdentity: country ? { country } : void 0
   });
   if (cart && !skipStoringCart) {

package/cart/cart-provider.d.ts

@@ -66,6 +66,8 @@ export interface CartContextTypeInternal {
  * For buy now functionality, use useBuyNow.
  */
 export interface CartContextType {
+    /** Current cart ID for integrations that track checkout attribution. */
+    cartId: string | null;
     /** Total number of items in cart */
     itemsCount: number;
     /** Whether the cart UI is open */

package/cart/cart-provider.js

@@ -675,6 +675,7 @@ function useCart() {
     });
   }
   return {
+    cartId: context.cartData?.id ?? null,
     itemsCount: context.itemsCount,
     isCartOpen: context.isCartOpen,
     openCart: context.openCart,

package/cart/gateways/cart-gateway.d.ts

@@ -11,6 +11,10 @@ export interface CartGateway {
     createCart(options?: {
         lines?: CartLinePayload[];
         discountCodes?: string[];
+        attributes?: {
+            key: string;
+            value: string;
+        }[];
         buyerIdentity?: CartBuyerIdentity;
     }): Promise<Cart | null>;
     addToCart(cartPayload: AddToCartPayload): Promise<Cart | null>;

package/cart/gateways/resolver-cart-gateway.js

@@ -11,6 +11,7 @@ class ResolverCartGateway {
   async createCart({
     lines,
     discountCodes,
+    attributes,
     buyerIdentity
   } = {}) {
     try {
@@ -26,6 +27,7 @@ class ResolverCartGateway {
           sellingPlanId: line.sellingPlanId
         })),
         discountCodes,
+        attributes,
         country: buyerIdentity?.country
       });
     } catch (error) {

package/cart/hooks/use-buy-now.d.ts

@@ -81,5 +81,10 @@ export interface VariantBuyNowInfo {
 export declare function useBuyNow(): {
     buyNow: (variants: VariantBuyNowInfo[], options?: {
         discountCodes?: string[];
+        /** Order-level Shopify cart attributes, including experiment attribution. */
+        attributes?: {
+            key: string;
+            value: string;
+        }[];
     }) => Promise<BuyNowOutcome>;
 };

package/cart/hooks/use-buy-now.js

@@ -35,6 +35,7 @@ function useBuyNow() {
           properties: variant.properties ?? []
         })),
         discountCodes: options?.discountCodes ?? [],
+        attributes: options?.attributes ?? [],
         pageUrl: window.location.href
       };
       const attemptStorageKey = `replo-checkout-attempt:${JSON.stringify(checkoutInput)}`;

package/consent/replo-scripts.js

@@ -57,7 +57,7 @@ function descriptorsFor(entry) {
   if (entry.type === "consentPlatform" || entry.type === "Cookiebot") {
     return [];
   }
-  return buildScriptTags({ type: entry.type, identifier: entry.identifier });
+  return buildScriptTags(entry);
 }
 class InjectedScript extends Component {
   componentDidMount() {
@@ -89,17 +89,31 @@ class ScriptRegistration extends Component {
     return null;
   }
 }
-function ManagedScript({ entry }) {
-  const requiredConsent = requiredConsentFor(entry);
+function registrationFor(entry) {
   const id = scriptId(entry);
+  const requiredConsent = requiredConsentFor(entry);
+  if (entry.type === "X") {
+    return {
+      id,
+      type: "X",
+      requiredConsent,
+      pixelId: entry.identifier,
+      events: entry.events ?? {}
+    };
+  }
+  return { id, type: entry.type, requiredConsent };
+}
+function ManagedScript({ entry }) {
+  const registration = registrationFor(entry);
+  const { id, requiredConsent } = registration;
   const isBlockedByNativeConsent = useIsBlockedByNativeConsent(requiredConsent);
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx(
       ScriptRegistration,
       {
-        script: { id, type: entry.type, requiredConsent }
+        script: registration
       },
-      `${id}:${requiredConsent.join(",")}`
+      JSON.stringify(registration)
     ),
     !isBlockedByNativeConsent && /* @__PURE__ */ jsx(
       InjectedScript,

package/consent/script-registration-store.d.ts

@@ -1,4 +1,4 @@
-import type { ConsentCategory, ReploScriptType } from "../_vendor/schemas/generated/consent";
+import type { ConsentCategory, ReploScriptType, XPixelEvents } from "../_vendor/schemas/generated/consent";
 /**
  * Tracks which managed scripts are currently mounted on the page. Each
  * `ReploScripts` entry registers itself here on mount, so the analytics provider
@@ -6,11 +6,16 @@ import type { ConsentCategory, ReploScriptType } from "../_vendor/schemas/genera
  * without importing a static list. Like the consent store, this is a singleton
  * rather than React context so it works regardless of tree position.
  */
-export interface RegisteredScript {
+export type RegisteredScript = {
     id: string;
-    type: ReploScriptType;
     requiredConsent: ConsentCategory[];
-}
+} & ({
+    type: Exclude<ReploScriptType, "X">;
+} | {
+    type: "X";
+    pixelId: string;
+    events: XPixelEvents;
+});
 /**
  * Registration id of a `snippet` entry. Snippet providers have no distinct
  * `type`, so both `ReploScripts` (registering) and the analytics sink factory

package/consent/script-snippets.d.ts

@@ -1,19 +1,19 @@
-import type { ConsentCategory, ReploScriptType, ScriptTagDescriptor } from "../_vendor/schemas/generated/consent";
+import type { ConsentCategory, ReploScriptEntry, ReploScriptType, ScriptTagDescriptor } from "../_vendor/schemas/generated/consent";
 type ProviderType = Exclude<ReploScriptType, "custom" | "snippet" | "consentPlatform" | "Cookiebot">;
 /**
  * Snippet providers don't synthesize tags (the user pastes the provider-issued
  * snippet as the entry's `body`), but they still get a first-class default
  * consent categorization like identifier providers.
  */
-/**
- * Returns the structured tag descriptors for a named provider. A single provider
- * can produce multiple tags (e.g. GA4 = external loader + inline config), which
- * the runtime injects in order.
- */
-export declare function buildScriptTags({ type, identifier, }: {
+/** IDs for another pixel would credit a different advertiser. */
+export declare function isXEventIdForPixel({ eventId, pixelId, }: {
+    eventId: string;
+    pixelId: string;
+}): boolean;
+/** The runtime injects these tags in order after consent allows tracking. */
+export declare function buildScriptTags(entry: Extract<ReploScriptEntry, {
     type: ProviderType;
-    identifier: string;
-}): ScriptTagDescriptor[];
+}>): ScriptTagDescriptor[];
 /**
  * The default consent categories that gate an identifier-provider script when an
  * entry does not specify `requiredConsent`. `snippet` and `custom` entries carry

package/consent/script-snippets.js

@@ -69,6 +69,15 @@ gtag('config', '${id}');`
       }
     ]
   },
+  X: {
+    defaultConsent: ["marketing"],
+    buildTags: (id) => [
+      {
+        kind: "inline",
+        body: `!function(e,t,n,s,u,a){e.twq||(s=e.twq=function(){s.exe?s.exe.apply(s,arguments):s.queue.push(arguments);},s.version='1.1',s.queue=[],u=t.createElement(n),u.async=!0,u.src='https://static.ads-twitter.com/uwt.js',a=t.getElementsByTagName(n)[0],a.parentNode.insertBefore(u,a))}(window,document,'script');twq('config','${id}');`
+      }
+    ]
+  },
   Hotjar: {
     defaultConsent: ["analytics"],
     buildTags: (id) => [
@@ -140,16 +149,33 @@ gtag('config', '${id}');`
     ]
   }
 };
-function buildScriptTags({
-  type,
-  identifier
+function isXEventIdForPixel({
+  eventId,
+  pixelId
 }) {
-  return PROVIDER_SNIPPETS[type].buildTags(identifier);
+  const match = /^tw-([a-z0-9]+)-[a-z0-9]+$/i.exec(eventId);
+  return match?.[1]?.toLowerCase() === pixelId.toLowerCase();
+}
+function buildScriptTags(entry) {
+  const tags = PROVIDER_SNIPPETS[entry.type].buildTags(entry.identifier);
+  if (entry.type === "X") {
+    const pageViewId = entry.events?.pageView?.trim();
+    if (pageViewId && isXEventIdForPixel({ eventId: pageViewId, pixelId: entry.identifier })) {
+      return tags.map((tag) => {
+        return tag.kind === "inline" ? {
+          ...tag,
+          body: `${tag.body}twq('event',${JSON.stringify(pageViewId)},{});`
+        } : tag;
+      });
+    }
+  }
+  return tags;
 }
 function defaultConsentFor(type) {
   return PROVIDER_SNIPPETS[type].defaultConsent;
 }
 export {
   buildScriptTags,
-  defaultConsentFor
+  defaultConsentFor,
+  isXEventIdForPixel
 };

package/consent/types.d.ts

@@ -1,4 +1,4 @@
-export type ReploScriptType = "GA4" | "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "Cookiebot" | "snippet" | "custom" | "consentPlatform";
+export type ReploScriptType = "GA4" | "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "X" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "Cookiebot" | "snippet" | "custom" | "consentPlatform";
 export type ConsentCategory = "necessary" | "analytics" | "marketing" | "preferences" | "sale_of_data";
 export type ConsentMode = "off" | "simple" | "per-category";
 declare module "react" {
@@ -16,10 +16,22 @@ export type ScriptTagDescriptor = {
     kind: "inline";
     body: string;
 };
+export type XPixelEvents = {
+    pageView?: string;
+    productViewed?: string;
+    addToCart?: string;
+    startCheckout?: string;
+    purchase?: string;
+};
 export type ReploScriptEntry = {
     type: "GA4" | "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "Cookiebot";
     identifier: string;
     requiredConsent?: ConsentCategory[];
+} | {
+    type: "X";
+    identifier: string;
+    events?: XPixelEvents;
+    requiredConsent?: ConsentCategory[];
 } | {
     type: "snippet";
     id: string;

package/gateways/canopy-api.d.ts

@@ -72,6 +72,10 @@ declare class CanopyApiGateway {
             sellingPlanId?: string | null;
         }[];
         discountCodes?: string[];
+        attributes?: {
+            key: string;
+            value: string;
+        }[];
         country?: StorefrontCountryCode;
     }): Promise<Cart>;
     cartAddLines({ cartId, lines, }: {

package/gateways/canopy-api.js

@@ -195,6 +195,7 @@ If you're running locally, make sure the canopy-api cloudflare worker is running
     return this._cartPost("/create", {
       lines: options?.lines,
       discountCodes: options?.discountCodes,
+      attributes: options?.attributes,
       country: options?.country
     });
   }

package/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "1.14.1",
+  "version": "1.16.0",
   "branch": "HEAD",
-  "commit": "19094c206182dc6886a38bbc6fcd1541c8123b64",
-  "builtAt": "2026-10-08T22:22:26.957Z"
+  "commit": "702e4d053e7d73e648c62dce85f5d14634d87bd8",
+  "builtAt": "2026-10-09T23:28:16.932Z"
 };

package/loaders/loader-keys.d.ts

@@ -10,6 +10,7 @@
  * `<integration>.<objectType>_<qualifier>`.
  */
 export declare const DATA_LOADER_KEYS: {
+    readonly SHOPIFY_INTEGRATION_DETAILS: "shopify_storefront.integration_details";
     readonly SHOPIFY_PRODUCT: "shopify_storefront.product";
     readonly SHOPIFY_COLLECTION: "shopify_storefront.collection";
     readonly SHOPIFY_COLLECTION_PRODUCTS: "shopify_storefront.collection_products";

package/loaders/loader-keys.js

@@ -1,4 +1,5 @@
 const DATA_LOADER_KEYS = {
+  SHOPIFY_INTEGRATION_DETAILS: "shopify_storefront.integration_details",
   SHOPIFY_PRODUCT: "shopify_storefront.product",
   SHOPIFY_COLLECTION: "shopify_storefront.collection",
   SHOPIFY_COLLECTION_PRODUCTS: "shopify_storefront.collection_products",

package/loaders/loader-schemas.d.ts

@@ -1098,3 +1098,8 @@ export type ShopifyKachingBundlesLoaderOutput = z.infer<typeof shopifyKachingBun
 export type StorefrontMetaobject = z.infer<typeof storefrontMetaobjectSchema>;
 export type ShopifyMetaobjectLoaderOutput = z.infer<typeof shopifyMetaobjectLoaderOutputSchema>;
 export type ShopifyMetaobjectsLoaderOutput = z.infer<typeof shopifyMetaobjectsLoaderOutputSchema>;
+export declare const shopifyIntegrationDetailsLoaderOutputSchema: z.ZodObject<{
+    shopifyDomain: z.ZodString;
+    storefrontAccessToken: z.ZodString;
+}, z.core.$strip>;
+export type ShopifyIntegrationDetails = z.infer<typeof shopifyIntegrationDetailsLoaderOutputSchema>;

package/loaders/loader-schemas.js

@@ -362,6 +362,14 @@ const shopifyMetaobjectsLoaderOutputSchema = z.object({
 const shopifyKachingBundlesLoaderOutputSchema = z.object({
   bundles: z.record(z.string(), z.unknown()).nullable()
 }).describe("ShopifyKachingBundles");
+const shopifyIntegrationDetailsLoaderOutputSchema = z.object({
+  shopifyDomain: z.string().min(1).describe(
+    "The connected store's myshopify.com domain, without a protocol."
+  ),
+  storefrontAccessToken: z.string().min(1).describe(
+    "Public Shopify Storefront API token intended for browser use. Never an Admin API or private Storefront token."
+  )
+});
 export {
   contentfulAssetObjectSchema,
   contentfulEntriesLoaderOutputSchema,
@@ -400,6 +408,7 @@ export {
   sellingPlanOptionValueSchema,
   sellingPlanPriceAdjustmentSchema,
   sellingPlanSchema,
+  shopifyIntegrationDetailsLoaderOutputSchema,
   shopifyKachingBundlesLoaderOutputSchema,
   shopifyMetaobjectLoaderOutputSchema,
   shopifyMetaobjectsLoaderOutputSchema,

package/loaders/shopify-integration-details-loader.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from "react";
+import type { ShopifyIntegrationDetails } from "./loader-schemas";
+type ShopifyIntegrationDetailsLoaderProps = {
+    loaderKey: string;
+    children: (data: ShopifyIntegrationDetails) => ReactNode;
+    fallback?: ReactNode;
+};
+export declare function ShopifyIntegrationDetailsLoader({ loaderKey, children, fallback, }: ShopifyIntegrationDetailsLoaderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/loaders/shopify-integration-details-loader.js

@@ -0,0 +1,33 @@
+"use client";
+import { Fragment, jsx } from "react/jsx-runtime";
+import { Suspense } from "react";
+import { useSuspenseQuery } from "@tanstack/react-query";
+import { invokeLoader } from "./invoke-loader";
+import { LoaderErrorBoundary } from "./loader-error-boundary";
+import { shopifyIntegrationDetailsLoaderOutputSchema } from "./loader-schemas";
+function ShopifyIntegrationDetailsLoaderInner({
+  loaderKey,
+  children
+}) {
+  const { data } = useSuspenseQuery({
+    queryKey: [loaderKey, {}],
+    queryFn: async () => {
+      const loadedData = await invokeLoader({
+        loaderKey,
+        args: {}
+      });
+      return shopifyIntegrationDetailsLoaderOutputSchema.parse(loadedData);
+    }
+  });
+  return /* @__PURE__ */ jsx(Fragment, { children: children(data) });
+}
+function ShopifyIntegrationDetailsLoader({
+  loaderKey,
+  children,
+  fallback
+}) {
+  return /* @__PURE__ */ jsx(LoaderErrorBoundary, { fallback: fallback ?? null, resetKey: loaderKey, children: /* @__PURE__ */ jsx(Suspense, { fallback: fallback ?? null, children: /* @__PURE__ */ jsx(ShopifyIntegrationDetailsLoaderInner, { loaderKey, children }) }) });
+}
+export {
+  ShopifyIntegrationDetailsLoader
+};

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@replohq/sdk",
-  "version": "1.14.1",
+  "version": "1.16.0",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "1.14.1",
+    "version": "1.16.0",
     "branch": "HEAD",
-    "commit": "19094c206182dc6886a38bbc6fcd1541c8123b64",
-    "builtAt": "2026-10-08T22:22:26.957Z"
+    "commit": "702e4d053e7d73e648c62dce85f5d14634d87bd8",
+    "builtAt": "2026-10-09T23:28:16.932Z"
   },
   "description": "Replo SDK — cart, analytics, and data loaders for agent-built Next.js sites.",
   "license": "SEE LICENSE IN LICENSE",
@@ -85,6 +85,10 @@
       "types": "./analytics/analytics-provider.d.ts",
       "default": "./analytics/analytics-provider.js"
     },
+    "./analytics/sinks/intelligems-sink": {
+      "types": "./analytics/sinks/intelligems-sink.d.ts",
+      "default": "./analytics/sinks/intelligems-sink.js"
+    },
     "./analytics/hooks/use-product-viewed-analytics": {
       "types": "./analytics/hooks/use-product-viewed-analytics.d.ts",
       "default": "./analytics/hooks/use-product-viewed-analytics.js"
@@ -165,6 +169,10 @@
       "types": "./loaders/reviews-io-reviews-loader.d.ts",
       "default": "./loaders/reviews-io-reviews-loader.js"
     },
+    "./loaders/shopify-integration-details-loader": {
+      "types": "./loaders/shopify-integration-details-loader.d.ts",
+      "default": "./loaders/shopify-integration-details-loader.js"
+    },
     "./loaders/smile-earning-rules-loader": {
       "types": "./loaders/smile-earning-rules-loader.d.ts",
       "default": "./loaders/smile-earning-rules-loader.js"