@replohq/sdk 1.15.0 → 1.16.0

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/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/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/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.15.0",
+  "version": "1.16.0",
   "branch": "HEAD",
-  "commit": "3759f7d83c0c4991b7ccbafed0d1b55da1ed48b4",
-  "builtAt": "2026-10-09T21:52:34.432Z"
+  "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.15.0",
+  "version": "1.16.0",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "1.15.0",
+    "version": "1.16.0",
     "branch": "HEAD",
-    "commit": "3759f7d83c0c4991b7ccbafed0d1b55da1ed48b4",
-    "builtAt": "2026-10-09T21:52:34.432Z"
+    "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"