@replohq/sdk 2.18.2 → 2.19.0

package/_vendor/replo-utils/lib/crypto.d.ts

@@ -22,4 +22,9 @@ export declare function getHmacSha256Hex({ rawBody, signingKey, }: {
     rawBody: string;
     signingKey: string;
 }): Promise<string>;
+export declare function isValidHmacSha256Hex({ rawBody, signingKey, signature, }: {
+    rawBody: string;
+    signingKey: string;
+    signature: string;
+}): Promise<boolean>;
 export declare function deterministicUUID(value: string): string;

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

@@ -1,4 +1,4 @@
-export type ReploScriptType = "GA4" | "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "X" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "Mixpanel" | "HubSpot" | "Attentive" | "Alia" | "Cookiebot" | "snippet" | "custom" | "consentPlatform";
+export type ReploScriptType = "GA4" | "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "X" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "Mixpanel" | "HubSpot" | "Attentive" | "Alia" | "Cookiebot" | "Usercentrics" | "snippet" | "custom" | "consentPlatform";
 export type ConsentCategory = "necessary" | "analytics" | "marketing" | "preferences" | "sale_of_data";
 export type ConsentMode = "off" | "simple" | "per-category";
 export type ScriptTagDescriptor = {
@@ -30,37 +30,49 @@ export type ReploScriptEntry = {
     type: "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "HubSpot" | "Attentive" | "Alia";
     identifier: string;
     requiredConsent?: ConsentCategory[];
+    usercentricsService?: string;
 } | {
     type: "GA4";
     identifier: string;
     requiredConsent?: ConsentCategory[];
     runtimeOwner?: ScriptRuntimeOwner;
+    usercentricsService?: string;
 } | {
     type: "X";
     identifier: string;
     events?: Partial<XPixelEvents>;
     requiredConsent?: ConsentCategory[];
+    usercentricsService?: string;
 } | {
     type: "Mixpanel";
     identifier: string;
     region?: MixpanelRegion;
     requiredConsent?: ConsentCategory[];
+    usercentricsService?: string;
 } | {
     type: "Cookiebot";
     identifier: string;
     requiredConsent?: ConsentCategory[];
+} | {
+    type: "Usercentrics";
+    identifier: string;
+    loaderVersion?: "v2" | "v3";
+    runtimeOwner?: ScriptRuntimeOwner;
+    reploUsercentricsService?: string;
 } | {
     type: "snippet";
     id: string;
     body: string;
     module?: boolean;
     requiredConsent: ConsentCategory[];
+    usercentricsService?: string;
 } | {
     type: "custom";
     id: string;
     requiredConsent: ConsentCategory[];
     src?: string;
     body?: string;
+    usercentricsService?: string;
 } | {
     type: "consentPlatform";
     id: string;

package/analytics/analytics-provider.js

@@ -37,7 +37,8 @@ function AnalyticsProvider({
           cmp: consent.cmp,
           mode: consent.mode,
           categories: consent.categories,
-          decidedAt: consent.decidedAt
+          decidedAt: consent.decidedAt,
+          grantedUsercentricsServices: consent.grantedUsercentricsServices
         },
         registeredScripts,
         checkoutProvider
@@ -49,6 +50,7 @@ function AnalyticsProvider({
     consent.mode,
     consent.categories,
     consent.decidedAt,
+    consent.grantedUsercentricsServices,
     registeredScripts,
     checkoutProvider,
     additionalSinks

package/analytics/get-analytics-sinks.js

@@ -1,3 +1,4 @@
+import { findDelegatedPlatform } from "../consent/consent-platform";
 import { isConsentAllowed } from "../consent/consent-store";
 import { snippetScriptId } from "../consent/script-registration-store";
 import { ConvergeSink } from "./sinks/converge-sink";
@@ -51,11 +52,12 @@ function getAnalyticsSinks({
   checkoutProvider
 }) {
   const sinks = [new WindowSink()];
-  const firstPartyAllowed = isConsentAllowed({
+  const isReploPixelAllowed = isConsentAllowed({
     state: consent,
-    requiredConsent: ["analytics"]
+    requiredConsent: ["analytics"],
+    usercentricsService: findDelegatedPlatform()?.reploUsercentricsService ?? null
   });
-  if (firstPartyAllowed) {
+  if (isReploPixelAllowed) {
     sinks.push(new ReploSink());
   }
   const shopifyOwnsCheckout = checkoutProvider === "shopify";
@@ -68,7 +70,8 @@ function getAnalyticsSinks({
     }
     if (isConsentAllowed({
       state: consent,
-      requiredConsent: script.requiredConsent
+      requiredConsent: script.requiredConsent,
+      usercentricsService: script.usercentricsService
     })) {
       const sink = factory();
       const gated = shopifyOwnsCheckout && !SHOPIFY_FUNNEL_GATE_EXEMPT_PROVIDERS.has(script.type);

package/analytics/replo-pixel-script.d.ts

@@ -4,11 +4,11 @@
  * events into, so gating it on `analytics` consent keeps the first-party sink
  * consent-correct without the pixel loading unconditionally in `<head>` the way
  * the legacy scaffold does. `analytics` consent here matches the
- * `firstPartyAllowed` gate that controls whether `ReploSink` is created at all.
+ * `isReploPixelAllowed` gate that controls whether `ReploSink` is created at all.
  *
- * Under a consent platform the tag is rendered regardless and `InjectedScript`
- * stamps the blocking attributes at mount time, since delegation is not yet
- * set here.
+ * Under a consent platform the tag is injected regardless, with its blocking
+ * attributes read in the effect because this renders before `ReploScripts`
+ * publishes the platform.
  */
 export declare function ReploPixelScript({ pixelUrl, apiUrl, projectId, siteVersion, }: {
     pixelUrl: string;
@@ -16,4 +16,4 @@ export declare function ReploPixelScript({ pixelUrl, apiUrl, projectId, siteVers
     projectId: string;
     /** Publish id of the running site; absent on unpublished or older deploys. */
     siteVersion?: string;
-}): import("react/jsx-runtime").JSX.Element | null;
+}): null;

package/analytics/replo-pixel-script.js

@@ -1,6 +1,7 @@
 "use client";
-import { jsx } from "react/jsx-runtime";
-import { InjectedScript } from "../consent/replo-scripts";
+import { useEffect } from "react";
+import { findDelegatedPlatform } from "../consent/consent-platform";
+import { injectGatedScript } from "../consent/inject-script-descriptors";
 import { useIsBlockedByNativeConsent } from "../consent/use-is-blocked-by-native-consent";
 const PIXEL_SCRIPT_ID = "replo:first-party-pixel";
 const PIXEL_REQUIRED_CONSENT = ["analytics"];
@@ -13,28 +14,28 @@ function ReploPixelScript({
   const isBlockedByNativeConsent = useIsBlockedByNativeConsent(
     PIXEL_REQUIRED_CONSENT
   );
-  if (isBlockedByNativeConsent) {
-    return null;
-  }
-  const descriptors = [
-    {
-      kind: "external",
-      src: `${pixelUrl}/latest.js`,
-      attributes: {
-        "data-api-url": apiUrl,
-        "data-project-id": projectId,
-        ...siteVersion ? { "data-site-version": siteVersion } : {}
-      }
+  useEffect(() => {
+    if (isBlockedByNativeConsent) {
+      return;
     }
-  ];
-  return /* @__PURE__ */ jsx(
-    InjectedScript,
-    {
+    injectGatedScript({
       baseId: PIXEL_SCRIPT_ID,
-      descriptors,
-      requiredConsent: PIXEL_REQUIRED_CONSENT
-    }
-  );
+      descriptors: [
+        {
+          kind: "external",
+          src: `${pixelUrl}/latest.js`,
+          attributes: {
+            "data-api-url": apiUrl,
+            "data-project-id": projectId,
+            ...siteVersion ? { "data-site-version": siteVersion } : {}
+          }
+        }
+      ],
+      requiredConsent: PIXEL_REQUIRED_CONSENT,
+      usercentricsService: findDelegatedPlatform()?.reploUsercentricsService ?? null
+    });
+  }, [isBlockedByNativeConsent, pixelUrl, apiUrl, projectId, siteVersion]);
+  return null;
 }
 export {
   ReploPixelScript

package/cart/cart-actions.js

@@ -1,5 +1,6 @@
 "use server";
 import { cookies } from "next/headers";
+import { readBuyerIp } from "../lib/buyer-ip";
 import { getCheckoutProvider } from "../lib/integration-utils";
 import { REPLO_ATTRIBUTION_PROPERTY } from "./cart-types";
 import {
@@ -23,7 +24,8 @@ async function reconcileExistingCart(cart, country) {
   if (country && reconciledCart.buyerIdentity?.country !== country) {
     return await cartGateway.updateCartBuyerIdentity({
       cartId: reconciledCart.id,
-      buyerIdentity: { country }
+      buyerIdentity: { country },
+      buyerIp: await readBuyerIp()
     });
   }
   return reconciledCart;
@@ -51,9 +53,10 @@ async function getCartAction() {
   const cartGateway = await getCartGateway();
   const sharedToken = checkoutProvider === "shopify" ? cookieStore.get(SHARED_SHOPIFY_CART_COOKIE_NAME)?.value : void 0;
   if (sharedToken) {
-    const sharedCart = await cartGateway.getCart(
-      `${SHOPIFY_CART_ID_PREFIX}${sharedToken}`
-    );
+    const sharedCart = await cartGateway.getCart({
+      cartId: `${SHOPIFY_CART_ID_PREFIX}${sharedToken}`,
+      buyerIp: await readBuyerIp()
+    });
     if (sharedCart) {
       return sharedCart;
     }
@@ -62,7 +65,10 @@ async function getCartAction() {
   if (!existingCartId) {
     return null;
   }
-  const cart = await cartGateway.getCart(existingCartId);
+  const cart = await cartGateway.getCart({
+    cartId: existingCartId,
+    buyerIp: await readBuyerIp()
+  });
   if (!cart) {
     try {
       cookieStore.set(SHOPIFY_CART_COOKIE_NAME, "", {
@@ -92,7 +98,8 @@ async function createCartAction(options) {
     lines,
     discountCodes,
     attributes,
-    buyerIdentity: country ? { country } : void 0
+    buyerIdentity: country ? { country } : void 0,
+    buyerIp: await readBuyerIp()
   });
   if (cart && !skipStoringCart) {
     try {
@@ -117,7 +124,8 @@ async function createCartAction(options) {
 }
 async function addToCartAction(lines, cartId) {
   const cartGateway = await getCartGateway();
-  const cart = await cartGateway.addToCart({ lines, cartId });
+  const buyerIp = await readBuyerIp();
+  const cart = await cartGateway.addToCart({ lines, cartId, buyerIp });
   if (!cart || await getCheckoutProvider() !== "shopify" || cart.attributes?.some(
     (attribute) => attribute.key === REPLO_ATTRIBUTION_PROPERTY.key
   )) {
@@ -125,29 +133,50 @@ async function addToCartAction(lines, cartId) {
   }
   const attributedCart = await cartGateway.replaceCartAttributes({
     cartId: cart.id,
-    attributes: [...cart.attributes ?? [], REPLO_ATTRIBUTION_PROPERTY]
+    attributes: [...cart.attributes ?? [], REPLO_ATTRIBUTION_PROPERTY],
+    buyerIp
   });
   return attributedCart ?? cart;
 }
 async function updateCartLineItemAction(line, cartId) {
   const cartGateway = await getCartGateway();
-  return await cartGateway.updateCartLineItem({ line, cartId });
+  return await cartGateway.updateCartLineItem({
+    line,
+    cartId,
+    buyerIp: await readBuyerIp()
+  });
 }
 async function removeCartLineItemsAction(lineIds, cartId) {
   const cartGateway = await getCartGateway();
-  return await cartGateway.removeCartLineItems({ lineIds, cartId });
+  return await cartGateway.removeCartLineItems({
+    lineIds,
+    cartId,
+    buyerIp: await readBuyerIp()
+  });
 }
 async function updateCartDiscountCodesAction(discountCodes, cartId) {
   const cartGateway = await getCartGateway();
-  return await cartGateway.updateCartDiscountCodes({ discountCodes, cartId });
+  return await cartGateway.updateCartDiscountCodes({
+    discountCodes,
+    cartId,
+    buyerIp: await readBuyerIp()
+  });
 }
 async function updateCartNoteAction(note, cartId) {
   const cartGateway = await getCartGateway();
-  return await cartGateway.updateCartNote({ note, cartId });
+  return await cartGateway.updateCartNote({
+    note,
+    cartId,
+    buyerIp: await readBuyerIp()
+  });
 }
 async function replaceCartAttributesAction(attributes, cartId) {
   const cartGateway = await getCartGateway();
-  return await cartGateway.replaceCartAttributes({ attributes, cartId });
+  return await cartGateway.replaceCartAttributes({
+    attributes,
+    cartId,
+    buyerIp: await readBuyerIp()
+  });
 }
 export {
   addToCartAction,

package/cart/checkout-actions.js

@@ -19,7 +19,7 @@ async function getCrossSellsAction(input) {
   if (await getCheckoutProvider() !== "stripe") {
     return [];
   }
-  return await (await getCanopyApiGateway()).findCrossSells(input);
+  return await getCanopyApiGateway().findCrossSells(input);
 }
 export {
   createCheckoutSessionAction,

package/cart/checkout-session-actions.js

@@ -1,10 +1,10 @@
 "use server";
 import { getCanopyApiGateway } from "../gateways/canopy-api";
 async function updateCheckoutShippingAction(input) {
-  return await (await getCanopyApiGateway()).updateCheckoutShipping(input);
+  return await getCanopyApiGateway().updateCheckoutShipping(input);
 }
 async function addCrossSellAction(input) {
-  return await (await getCanopyApiGateway()).addCrossSell(input);
+  return await getCanopyApiGateway().addCrossSell(input);
 }
 export {
   addCrossSellAction,

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

@@ -1,6 +1,11 @@
 import type { AddToCartPayload, Cart, CartBuyerIdentity, CartLinePayload, RemoveFromCartPayload, ReplaceCartAttributesPayload, UpdateCartDiscountCodesPayload, UpdateCartLineItemPayload, UpdateCartNotePayload } from "../cart-types";
+/** `buyerIp` is the shopper's IP; Shopify carts forward it, others ignore it. */
 export interface CartGateway {
-    getCart(cartId: string): Promise<Cart | null>;
+    getCart(request: {
+        cartId: string;
+    } & {
+        buyerIp: string | null;
+    }): Promise<Cart | null>;
     /**
      * Bring a stored cart back in line with its source of truth. Cookie carts
      * reprice against the catalog and drop unavailable lines (persisting the
@@ -8,7 +13,7 @@ export interface CartGateway {
      * cart unchanged.
      */
     reconcileStoredCart(cart: Cart): Promise<Cart>;
-    createCart(options?: {
+    createCart(options: {
         lines?: CartLinePayload[];
         discountCodes?: string[];
         attributes?: {
@@ -16,16 +21,32 @@ export interface CartGateway {
             value: string;
         }[];
         buyerIdentity?: CartBuyerIdentity;
+    } & {
+        buyerIp: string | null;
+    }): Promise<Cart | null>;
+    addToCart(cartPayload: AddToCartPayload & {
+        buyerIp: string | null;
     }): Promise<Cart | null>;
-    addToCart(cartPayload: AddToCartPayload): Promise<Cart | null>;
     updateCartBuyerIdentity(payload: {
         cartId: string;
         buyerIdentity: CartBuyerIdentity;
+    } & {
+        buyerIp: string | null;
+    }): Promise<Cart | null>;
+    updateCartLineItem(cartPayload: UpdateCartLineItemPayload & {
+        buyerIp: string | null;
+    }): Promise<Cart | null>;
+    removeCartLineItems(cartPayload: RemoveFromCartPayload & {
+        buyerIp: string | null;
+    }): Promise<Cart | null>;
+    updateCartDiscountCodes(cartPayload: UpdateCartDiscountCodesPayload & {
+        buyerIp: string | null;
+    }): Promise<Cart | null>;
+    updateCartNote(cartPayload: UpdateCartNotePayload & {
+        buyerIp: string | null;
+    }): Promise<Cart | null>;
+    replaceCartAttributes(cartPayload: ReplaceCartAttributesPayload & {
+        buyerIp: string | null;
     }): Promise<Cart | null>;
-    updateCartLineItem(cartPayload: UpdateCartLineItemPayload): Promise<Cart | null>;
-    removeCartLineItems(cartPayload: RemoveFromCartPayload): Promise<Cart | null>;
-    updateCartDiscountCodes(cartPayload: UpdateCartDiscountCodesPayload): Promise<Cart | null>;
-    updateCartNote(cartPayload: UpdateCartNotePayload): Promise<Cart | null>;
-    replaceCartAttributes(cartPayload: ReplaceCartAttributesPayload): Promise<Cart | null>;
 }
 export declare function getCartGateway(): Promise<CartGateway>;

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

@@ -27,8 +27,10 @@ export declare abstract class CookieBasedCartGateway implements CartGateway {
     private reconcile;
     private reconcileForWrite;
     reconcileStoredCart(cart: Cart): Promise<Cart>;
-    getCart(cartId: string): Promise<Cart | null>;
-    createCart({ lines, }?: {
+    getCart({ cartId }: {
+        cartId: string;
+    }): Promise<Cart | null>;
+    createCart({ lines, }: {
         lines?: CartLinePayload[];
         discountCodes?: string[];
         buyerIdentity?: CartBuyerIdentity;

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

@@ -51,7 +51,7 @@ class CookieBasedCartGateway {
     }
     return reconciledCart;
   }
-  async getCart(cartId) {
+  async getCart({ cartId }) {
     try {
       const cart = await loadCartFromCookie(this.config.cookieName);
       return cart?.id === cartId ? cart : null;
@@ -65,7 +65,7 @@ class CookieBasedCartGateway {
   }
   async createCart({
     lines
-  } = {}) {
+  }) {
     try {
       const cart = await createCartWithPersistence({
         cookieName: this.config.cookieName,
@@ -146,7 +146,7 @@ class CookieBasedCartGateway {
       `${this.config.gatewayName} cart gateway does not yet support discount codes`
     );
     try {
-      return await this.getCart(cartPayload.cartId);
+      return await this.getCart({ cartId: cartPayload.cartId });
     } catch (error) {
       console.warn("Failed to fetch cart for discount code update:", error);
       return null;
@@ -155,7 +155,7 @@ class CookieBasedCartGateway {
   async updateCartBuyerIdentity({
     cartId
   }) {
-    return this.getCart(cartId);
+    return this.getCart({ cartId });
   }
   async updateCartNote({
     cartId,

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

@@ -4,18 +4,21 @@ class ResolverCartGateway {
   async reconcileStoredCart(cart) {
     return cart;
   }
-  async getCart(cartId) {
-    const gateway = await getCanopyApiGateway();
-    return await gateway.cartGet({ cartId });
+  async getCart({
+    cartId,
+    buyerIp
+  }) {
+    return await getCanopyApiGateway().cartGet({ cartId, buyerIp });
   }
   async createCart({
     lines,
     discountCodes,
     attributes,
-    buyerIdentity
-  } = {}) {
+    buyerIdentity,
+    buyerIp
+  }) {
     try {
-      const gateway = await getCanopyApiGateway();
+      const gateway = getCanopyApiGateway();
       return await gateway.cartCreate({
         lines: lines?.map((line) => ({
           merchandiseId: line.id,
@@ -28,7 +31,8 @@ class ResolverCartGateway {
         })),
         discountCodes,
         attributes,
-        country: buyerIdentity?.country
+        country: buyerIdentity?.country,
+        buyerIp
       });
     } catch (error) {
       console.warn("Failed to create cart via canopy-api:", error);
@@ -37,9 +41,10 @@ class ResolverCartGateway {
   }
   async addToCart(cartPayload) {
     try {
-      const gateway = await getCanopyApiGateway();
+      const gateway = getCanopyApiGateway();
       return await gateway.cartAddLines({
         cartId: cartPayload.cartId,
+        buyerIp: cartPayload.buyerIp,
         lines: cartPayload.lines.map((line) => ({
           merchandiseId: line.id,
           quantity: line.quantity,
@@ -57,9 +62,10 @@ class ResolverCartGateway {
   }
   async updateCartLineItem(cartPayload) {
     try {
-      const gateway = await getCanopyApiGateway();
+      const gateway = getCanopyApiGateway();
       return await gateway.cartUpdateLines({
         cartId: cartPayload.cartId,
+        buyerIp: cartPayload.buyerIp,
         lines: [
           {
             lineId: cartPayload.line.id,
@@ -79,9 +85,10 @@ class ResolverCartGateway {
   }
   async removeCartLineItems(cartPayload) {
     try {
-      const gateway = await getCanopyApiGateway();
+      const gateway = getCanopyApiGateway();
       return await gateway.cartRemoveLines({
         cartId: cartPayload.cartId,
+        buyerIp: cartPayload.buyerIp,
         lineIds: cartPayload.lineIds
       });
     } catch (error) {
@@ -91,9 +98,10 @@ class ResolverCartGateway {
   }
   async updateCartDiscountCodes(cartPayload) {
     try {
-      const gateway = await getCanopyApiGateway();
+      const gateway = getCanopyApiGateway();
       return await gateway.cartUpdateDiscountCodes({
         cartId: cartPayload.cartId,
+        buyerIp: cartPayload.buyerIp,
         discountCodes: cartPayload.discountCodes
       });
     } catch (error) {
@@ -103,13 +111,15 @@ class ResolverCartGateway {
   }
   async updateCartBuyerIdentity({
     cartId,
-    buyerIdentity
+    buyerIdentity,
+    buyerIp
   }) {
     try {
-      const gateway = await getCanopyApiGateway();
+      const gateway = getCanopyApiGateway();
       return await gateway.cartUpdateBuyerIdentity({
         cartId,
-        country: buyerIdentity.country
+        country: buyerIdentity.country,
+        buyerIp
       });
     } catch (error) {
       console.warn(
@@ -121,9 +131,10 @@ class ResolverCartGateway {
   }
   async updateCartNote(cartPayload) {
     try {
-      const gateway = await getCanopyApiGateway();
+      const gateway = getCanopyApiGateway();
       return await gateway.cartUpdateNote({
         cartId: cartPayload.cartId,
+        buyerIp: cartPayload.buyerIp,
         note: cartPayload.note
       });
     } catch (error) {
@@ -133,9 +144,10 @@ class ResolverCartGateway {
   }
   async replaceCartAttributes(cartPayload) {
     try {
-      const gateway = await getCanopyApiGateway();
+      const gateway = getCanopyApiGateway();
       return await gateway.cartReplaceAttributes({
         cartId: cartPayload.cartId,
+        buyerIp: cartPayload.buyerIp,
         attributes: cartPayload.attributes.map((attribute) => ({
           key: attribute.key,
           value: String(attribute.value)

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

@@ -19,7 +19,7 @@ class StripeCartGateway extends CookieBasedCartGateway {
     cartIdGenerator: stripeCartIdGenerator,
     gatewayName: "Stripe",
     reconcileLines: async (lines) => {
-      const gateway = await getCanopyApiGateway();
+      const gateway = getCanopyApiGateway();
       return await gateway.reconcileCartLines({ lines });
     }
   };

package/cart/start-stripe-checkout.js

@@ -37,7 +37,7 @@ async function startStripeCheckout({
       "[Replo] Stripe buy now does not support selling plans or discount codes; those options were ignored."
     );
   }
-  const outcome = await (await getCanopyApiGateway()).createStripeCheckoutSession({
+  const outcome = await getCanopyApiGateway().createStripeCheckoutSession({
     checkoutAttemptId: checkoutAttemptId ?? uuidv4(),
     lines: lineItems.map((item) => ({
       variantId: item.variantId,

package/consent/consent-platform.d.ts

@@ -7,15 +7,21 @@ export interface ConsentPlatformConfig {
         name: string;
         values: Partial<Record<ConsentCategory, string>>;
     };
-    /** Cookiebot preset only: enables consent read-back and runScripts re-scan. */
-    isCookiebot: boolean;
+    /** Presets read the visitor's answer back; a generic platform only reports grants. */
+    kind: "cookiebot" | "usercentrics" | "generic";
+    /** Usercentrics only: the service that releases Replo's own pixel, or null until one is chosen. */
+    reploUsercentricsService: string | null;
+    /** The GTM container that loads this platform, which therefore can't wait for it. */
+    loaderContainerId: string | null;
 }
 /** Whether this entry connects a consent platform (vs a tracker it would gate). */
-export declare function isConsentPlatformEntry(entry: ReploScriptEntry): boolean;
+export declare function isConsentPlatformEntry(entry: ReploScriptEntry): entry is Extract<ReploScriptEntry, {
+    type: "Cookiebot" | "Usercentrics" | "consentPlatform";
+}>;
 /** The connected platform's config, or null when Replo's banner owns consent. */
 export declare function findConsentPlatform(scripts: ReploScriptEntry[]): ConsentPlatformConfig | null;
 /** Blocks a gated script; `text/plain` is unconditional so an unmapped category fails closed. */
-export declare function getBlockingAttributes(config: ConsentPlatformConfig, requiredConsent: ConsentCategory[]): Record<string, string>;
+export declare function getBlockingAttributes(config: ConsentPlatformConfig, requiredConsent: ConsentCategory[], usercentricsService: string | null): Record<string, string>;
 /** The bits of Cookiebot's `window.Cookiebot` global we read. */
 interface CookiebotGlobal {
     consent?: Partial<Record<CookiebotCategory, boolean>>;
@@ -26,6 +32,14 @@ type CookiebotCategory = "necessary" | "preferences" | "statistics" | "marketing
 declare global {
     interface Window {
         Cookiebot?: CookiebotGlobal;
+        __ucCmp?: {
+            getConsentDetails?: () => Promise<unknown>;
+            refreshScripts?: () => Promise<unknown>;
+        };
+        UC_UI?: {
+            getServicesBaseInfo?: () => unknown;
+            enableScriptsForServicesWithConsent?: () => unknown;
+        };
     }
 }
 type OptionalConsentCategory = Exclude<ConsentCategory, "necessary">;
@@ -36,12 +50,13 @@ export declare function findDelegatedPlatform(): ConsentPlatformConfig | null;
 export declare function getDelegatedConsent(): {
     categories: ConsentCategories;
     decidedAt: number | null;
+    grantedUsercentricsServices?: string[];
 };
 /** Inline marker a generic CMP executes when it releases one consent category. */
 export declare function buildGrantMarker(category: OptionalConsentCategory): ScriptTagDescriptor;
 /** Latches the platform as the consent backend; un-delegating would need a reload, as native revocation already does. */
 export declare function enableConsentDelegation(config: ConsentPlatformConfig): void;
-/** Cookiebot-only re-scan; other platforms rely on the loader injecting after every tag. */
+/** Re-scan for late tags; a generic platform relies on the loader injecting after every tag. */
 export declare function activateBlockedScripts(): void;
 /** Subscribe to delegated-consent changes. Returns an unsubscribe function. */
 export declare function subscribeToConsentDelegation(listener: () => void): () => void;