@replohq/sdk 2.20.0 → 2.20.2

package/README.md

@@ -1,177 +1,7 @@
 # `@replohq/sdk`
 
-The Replo SDK provides the React providers, data loaders, cart utilities,
-analytics, consent handling, routing helpers, and Next.js integrations used by
-Replo-powered storefronts.
+React providers, data loaders, cart utilities, analytics, and Next.js integrations for Replo storefronts.
 
-## Installation
+Install, set up, and read the API reference: https://docs.replo.app/sdk
 
-Install the SDK and its runtime peers in a Next.js application:
-
-```sh
-pnpm add @replohq/sdk @opennextjs/cloudflare @tanstack/react-query
-```
-
-The application must use Next.js 15 or newer and React 18.2 or newer. React,
-React DOM, and their type packages are peer dependencies and are normally
-already present in a Next.js application.
-
-## Set up the provider
-
-Mount `ReploProvider` once around the application. It provides the query
-client, cart state, analytics, and loader error handling used by the rest of
-the SDK. Render managed third-party scripts separately with `ReploScripts` from
-`@replohq/sdk/consent/replo-scripts`.
-
-```tsx
-// app/layout.tsx
-import { ReploProvider } from "@replohq/sdk/providers/replo-provider";
-
-export default function RootLayout({ children }: React.PropsWithChildren) {
-  return (
-    <html lang="en">
-      <body>
-        <ReploProvider>{children}</ReploProvider>
-      </body>
-    </html>
-  );
-}
-```
-
-`ReploProvider` is an async Server Component. Components that use SDK hooks or
-loaders must render beneath it.
-
-## Buy now checkout
-
-Use `useBuyNow` from `@replohq/sdk/cart/hooks/use-buy-now` to send a shopper
-directly to checkout. Shopify checkout applies selling plans and discount codes.
-Stripe checkout ignores both, logs a server warning when either is supplied,
-and still creates the checkout session.
-
-## Data loaders
-
-Data loaders retrieve data from integrations configured for the Replo project.
-Use constants from `DATA_LOADER_KEYS` instead of copying loader-key strings.
-The key selects the integration operation and is also the first part of the
-React Query cache key.
-
-Loader components are Client Components that pass data to a render function:
-
-```tsx
-// components/product-title.tsx
-"use client";
-
-import { ProductLoader } from "@replohq/sdk/loaders/product-loader";
-import { DATA_LOADER_KEYS } from "@replohq/sdk/loaders/loader-keys";
-
-export function ProductTitle({ handle }: { handle: string }) {
-  return (
-    <ProductLoader
-      loaderKey={DATA_LOADER_KEYS.SHOPIFY_PRODUCT}
-      handle={handle}
-      loadingFallback={<p>Loading…</p>}
-      fallback={<p>Product unavailable.</p>}
-    >
-      {(product) => <h1>{product.title}</h1>}
-    </ProductLoader>
-  );
-}
-```
-
-### Loader environments and integrations
-
-Loaders fetch on the server: directly during SSR, and through a Server Action
-after hydration. The application needs its Replo project configuration in every
-environment:
-
-- During local development and builds, `wrangler.jsonc` must provide
-  `CANOPY_API_HOST` and `PROJECT_ID` in `vars`.
-- In a deployed OpenNext/Cloudflare environment, provide the same values as
-  runtime bindings.
-- Connect each integration in the Replo project; the site holds no provider
-  credentials.
-
-Use these public loader components and keys for each configured integration:
-
-| Integration | Loader component | `DATA_LOADER_KEYS` value |
-| --- | --- | --- |
-| Shopify Storefront | `ProductLoader` | `SHOPIFY_PRODUCT` |
-| Replo product catalog | `ProductLoader` | `REPLO_PRODUCT` |
-| Shopify Storefront | `CollectionLoader` | `SHOPIFY_COLLECTION` |
-| Shopify Storefront | `CollectionProductsLoader` | `SHOPIFY_COLLECTION_PRODUCTS` |
-| Shopify Storefront | `MetaobjectLoader` | `SHOPIFY_METAOBJECT` |
-| Shopify Storefront | `MetaobjectsLoader` | `SHOPIFY_METAOBJECTS` |
-| Shopify Storefront | `ShopLoader` | `SHOPIFY_SHOP` |
-| Okendo | `OkendoReviewsLoader` | `OKENDO_PRODUCT_REVIEWS` |
-| Okendo | `OkendoReviewAggregateLoader` | `OKENDO_PRODUCT_REVIEW_AGGREGATE` |
-| Rebuy | `RebuyRecommendationsLoader` | `REBUY_RECOMMENDATIONS` |
-| Levanta | `LevantaProductLoader` | `LEVANTA_PRODUCT` |
-| Smile.io | `SmileVipTiersLoader` | `SMILE_IO_VIP_TIERS` |
-| Smile.io | `SmileEarningRulesLoader` | `SMILE_IO_EARNING_RULES` |
-| Smile.io | `SmileRewardsLoader` | `SMILE_IO_REWARDS` |
-| LoyaltyLion | `LoyaltyLionEarningRulesLoader` | `LOYALTYLION_EARNING_RULES` |
-| LoyaltyLion | `LoyaltyLionRewardsLoader` | `LOYALTYLION_REWARDS` |
-| LoyaltyLion | `LoyaltyLionTiersLoader` | `LOYALTYLION_TIERS` |
-| LoyaltyLion | `LoyaltyLionPointsForPriceLoader` | `LOYALTYLION_POINTS_FOR_PRICE` |
-| Yotpo | `YotpoReviewsLoader` | `YOTPO_PRODUCT_REVIEWS` |
-| Yotpo | `YotpoReviewAggregateLoader` | `YOTPO_PRODUCT_REVIEW_AGGREGATE` |
-| Reviews.io | `ReviewsIoReviewsLoader` | `REVIEWS_IO_PRODUCT_REVIEWS` |
-| Reviews.io | `ReviewsIoReviewAggregateLoader` | `REVIEWS_IO_PRODUCT_REVIEW_AGGREGATE` |
-| Loox | `LooxReviewsLoader` | `LOOX_PRODUCT_REVIEWS` |
-| Loox | `LooxReviewAggregateLoader` | `LOOX_PRODUCT_REVIEW_AGGREGATE` |
-| Judge.me | `JudgemeReviewsLoader` | `JUDGEME_PRODUCT_REVIEWS` |
-| Judge.me | `JudgemeReviewAggregateLoader` | `JUDGEME_PRODUCT_REVIEW_AGGREGATE` |
-| Statsig | `StatsigExperimentLoader` | `STATSIG_EXPERIMENT` |
-| Contentful | `ContentfulEntryLoader` | `CONTENTFUL_ENTRY` |
-| Contentful | `ContentfulEntriesLoader` | `CONTENTFUL_ENTRIES` |
-
-Import each component from its kebab-case subpath, for example
-`CollectionLoader` from `@replohq/sdk/loaders/collection-loader`.
-
-### Prefetch on the server
-
-`PrefetchedLoaders` is a Server Component that fetches loader data during SSR
-and hydrates the React Query cache. Wrap the matching Client Component to avoid
-a loading state on the first paint:
-
-```tsx
-// app/products/[handle]/page.tsx
-import { PrefetchedLoaders } from "@replohq/sdk/loaders/prefetch-loaders";
-import { DATA_LOADER_KEYS } from "@replohq/sdk/loaders/loader-keys";
-
-import { ProductTitle } from "../../../components/product-title";
-
-export default async function ProductPage({
-  params,
-}: {
-  params: Promise<{ handle: string }>;
-}) {
-  const { handle } = await params;
-
-  return (
-    <PrefetchedLoaders
-      queries={[
-        {
-          loaderKey: DATA_LOADER_KEYS.SHOPIFY_PRODUCT,
-          args: { handle },
-        },
-      ]}
-    >
-      <ProductTitle handle={handle} />
-    </PrefetchedLoaders>
-  );
-}
-```
-
-The `loaderKey` and complete `args` object must exactly match the props used by
-the loader component, including optional locale, pagination, or metafield
-arguments. `PrefetchedLoaders` accepts `revalidateSeconds` per query; it
-defaults to 60 seconds, and `false` enables indefinite tag-based caching.
-
-Server-only code that does not hydrate a loader component can call
-`invokeLoaderServer` from `@replohq/sdk/loaders/invoke-loader-server`.
-
-## License
-
-This package is proprietary software. See [LICENSE](./LICENSE)
-(`SEE LICENSE IN LICENSE`) and the [Replo Terms of Service](https://replo.app/terms).
+This package is proprietary software. Use is covered by the Replo Terms of Service (https://replo.app/terms).

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

@@ -1,6 +1,2 @@
 export declare function parseJsonOrNull(json: string): unknown | null;
-export declare function omitJsonObjectFieldsOrNull({ json, fields, }: {
-    json: string;
-    fields: string[];
-}): string | null;
 export declare function jsonStringifyOrNull(value: unknown): string | null;

package/_vendor/replo-utils/lib/json.mjs

@@ -1,4 +1 @@
-export { jsonStringifyOrNull, omitJsonObjectFieldsOrNull, parseJsonOrNull } from '../../../chunk-QYGRVXWQ.mjs';
-import '../../../chunk-DMJ5VUD6.mjs';
-import '../../../chunk-GNIXARC7.mjs';
-import '../../../chunk-JBCOJHZN.mjs';
+export { jsonStringifyOrNull, parseJsonOrNull } from '../../../chunk-B7XDEXPL.mjs';

package/_vendor/replo-utils/lib/misc.mjs

@@ -1,6 +1,6 @@
+export { isNumber_default as isNumber, isString_default as isString } from '../../../chunk-GNIXARC7.mjs';
 import { nodeUtil_default, baseUnary_default, getTag_default, identity_default, isFunction_default, defineProperty_default, isArrayLike_default, isIndex_default, eq_default, Stack_default, keysIn_default, isBuffer_default, isTypedArray_default, isArguments_default, isPrototype_default, baseKeys_default, baseAssignValue_default, getAllKeysIn_default, getAllKeys_default, keys_default, getPrototype_default, getSymbolsIn_default, getSymbols_default, Uint8Array_default, assignValue_default } from '../../../chunk-N4WC2Z43.mjs';
 export { isFunction_default as isFunction } from '../../../chunk-N4WC2Z43.mjs';
-export { isNumber_default as isNumber, isString_default as isString } from '../../../chunk-GNIXARC7.mjs';
 import { root_default, Symbol_default, isObjectLike_default, isObject_default, isArray_default, baseGetTag_default } from '../../../chunk-JBCOJHZN.mjs';
 
 function arrayEach(array, iteratee) {

package/_vendor/replo-utils/lib/object.mjs

@@ -1,3 +1,89 @@
-export { deepEqual, filterUndefined, forEachPrimitiveValue, omit, shallowEqual, toNullableIfDefined } from '../../../chunk-DMJ5VUD6.mjs';
-import '../../../chunk-GNIXARC7.mjs';
-import '../../../chunk-JBCOJHZN.mjs';
+import { isString_default, isNumber_default } from '../../../chunk-GNIXARC7.mjs';
+import { isObject_default } from '../../../chunk-JBCOJHZN.mjs';
+
+var has = Object.prototype.hasOwnProperty;
+function dequal(foo, bar) {
+  var ctor, len;
+  if (foo === bar) return true;
+  if (foo && bar && (ctor = foo.constructor) === bar.constructor) {
+    if (ctor === Date) return foo.getTime() === bar.getTime();
+    if (ctor === RegExp) return foo.toString() === bar.toString();
+    if (ctor === Array) {
+      if ((len = foo.length) === bar.length) {
+        while (len-- && dequal(foo[len], bar[len])) ;
+      }
+      return len === -1;
+    }
+    if (!ctor || typeof foo === "object") {
+      len = 0;
+      for (ctor in foo) {
+        if (has.call(foo, ctor) && ++len && !has.call(bar, ctor)) return false;
+        if (!(ctor in bar) || !dequal(foo[ctor], bar[ctor])) return false;
+      }
+      return Object.keys(bar).length === len;
+    }
+  }
+  return foo !== foo && bar !== bar;
+}
+
+function forEachPrimitiveValue({
+  target,
+  fn,
+  valueConversionFunction
+}) {
+  if (!target) {
+    return;
+  }
+  for (const [key, value] of Object.entries(target)) {
+    if (isObject_default(value)) {
+      const newTarget = valueConversionFunction ? valueConversionFunction(value) : value;
+      forEachPrimitiveValue({ target: newTarget, fn });
+    }
+    if (isString_default(value) || isNumber_default(value)) {
+      fn(value, key, target);
+    }
+  }
+}
+function shallowEqual(objA, objB) {
+  if (Object.is(objA, objB)) {
+    return true;
+  }
+  if (typeof objA !== "object" || objA === null || typeof objB !== "object" || objB === null) {
+    return false;
+  }
+  const keysA = Object.keys(objA);
+  const keysB = Object.keys(objB);
+  if (keysA.length !== keysB.length) {
+    return false;
+  }
+  for (let i = 0; i < keysA.length; i++) {
+    const currentKey = keysA[i];
+    if (!Object.hasOwnProperty.call(objB, currentKey) ||
+    !Object.is(objA[currentKey], objB[currentKey])) {
+      return false;
+    }
+  }
+  return true;
+}
+var deepEqual = dequal;
+function omit(obj, keysToOmit) {
+  const result = { ...obj };
+  for (const key of keysToOmit) {
+    delete result[key];
+  }
+  return result;
+}
+function filterUndefined(data) {
+  const result = {};
+  for (const [key, value] of Object.entries(data)) {
+    if (value !== void 0) {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+function toNullableIfDefined(value) {
+  return value === void 0 ? void 0 : value ?? null;
+}
+
+export { deepEqual, filterUndefined, forEachPrimitiveValue, omit, shallowEqual, toNullableIfDefined };

package/_vendor/schemas/contentManifest.mjs

@@ -1,10 +1,8 @@
 import { parseContentEntryDocument, getContentRenderableEntryValues, getContentEntryFieldValidationIssues } from '../../chunk-4YTXURVN.mjs';
 import { isValidContentSlug, CONTENT_COLLECTION_SCHEMA_FILENAME, CONTENT_ENTRY_FILE_EXTENSION, contentCollectionFileSchema, CONTENT_ENTRY_PUBLISHED_FILE_EXTENSION } from '../../chunk-RQ76VK3L.mjs';
 import '../../chunk-N4WC2Z43.mjs';
-import { parseJsonOrNull } from '../../chunk-QYGRVXWQ.mjs';
-import '../../chunk-DMJ5VUD6.mjs';
-import '../../chunk-GNIXARC7.mjs';
 import '../../chunk-JBCOJHZN.mjs';
+import { parseJsonOrNull } from '../../chunk-B7XDEXPL.mjs';
 import * as z from 'zod';
 
 var contentManifestSchema = z.object({

package/chunk-B7XDEXPL.mjs

@@ -0,0 +1,19 @@
+function parseJsonOrNull(json) {
+  try {
+    return JSON.parse(json);
+  } catch {
+    return null;
+  }
+}
+function jsonStringifyOrNull(value) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return null;
+  }
+}
+
+export { jsonStringifyOrNull, parseJsonOrNull };

package/consent/replo-scripts.d.ts

@@ -1,6 +1,5 @@
 import type { ScriptTagDescriptor } from "../_vendor/schemas/generated/consent";
 import type { ConsentCategory, ReploScriptEntry } from "./types";
-import { Component } from "react";
 /**
  * Injects the resolved tags into `document.head` once a caller has decided
  * consent allows it. Reused both for author-managed `ReploScripts` entries and
@@ -16,12 +15,9 @@ type InjectedScriptProps = {
     descriptors: ScriptTagDescriptor[];
     /** Used under a delegated platform to derive the attributes that gate the tag. */
     requiredConsent?: ConsentCategory[];
-    usercentricsService?: string;
+    usercentricsService?: string | null;
 };
-export declare class InjectedScript extends Component<InjectedScriptProps> {
-    componentDidMount(): void;
-    render(): null;
-}
+export declare function InjectedScript({ baseId, descriptors, requiredConsent, usercentricsService, }: InjectedScriptProps): null;
 /**
  * The single registry component for all managed tracking scripts on the site.
  * Authored once in `app/layout.tsx`; the agent/miniapp only edit the `scripts`

package/consent/replo-scripts.js

@@ -1,6 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { Component } from "react";
+import { useEffect } from "react";
 import {
   buildGrantMarker,
   enableConsentDelegation,
@@ -59,30 +59,30 @@ function descriptorsFor(entry) {
   }
   return buildScriptTags(entry);
 }
-class InjectedScript extends Component {
-  componentDidMount() {
-    const { requiredConsent = [], usercentricsService = null } = this.props;
+function InjectedScript({
+  baseId,
+  descriptors,
+  requiredConsent = [],
+  usercentricsService = null
+}) {
+  useEffect(() => {
     injectGatedScript({
-      baseId: this.props.baseId,
-      descriptors: this.props.descriptors,
+      baseId,
+      descriptors,
       requiredConsent,
       usercentricsService
     });
-  }
-  render() {
-    return null;
-  }
+  }, []);
+  return null;
 }
-class ScriptRegistration extends Component {
-  componentDidMount() {
-    registerScript(this.props.script);
-  }
-  componentWillUnmount() {
-    unregisterScript(this.props.script.id);
-  }
-  render() {
-    return null;
-  }
+function ScriptRegistration({ script }) {
+  useEffect(() => {
+    registerScript(script);
+    return () => {
+      unregisterScript(script.id);
+    };
+  }, []);
+  return null;
 }
 function registrationFor(entry, loaderContainerId) {
   const id = scriptId(entry);
@@ -121,23 +121,16 @@ function ManagedScript({
         baseId: id,
         descriptors: descriptorsFor(entry),
         requiredConsent,
-        usercentricsService: usercentricsService ?? void 0
+        usercentricsService
       }
     )
   ] });
 }
-class ConsentWindowApi extends Component {
-  uninstall = () => {
-  };
-  componentDidMount() {
-    this.uninstall = installConsentWindowApi();
-  }
-  componentWillUnmount() {
-    this.uninstall();
-  }
-  render() {
-    return null;
-  }
+function ConsentWindowApi() {
+  useEffect(() => {
+    return installConsentWindowApi();
+  }, []);
+  return null;
 }
 function ReploScripts({ scripts }) {
   const platform = findConsentPlatform(scripts);

package/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "2.20.0",
+  "version": "2.20.2",
   "branch": "HEAD",
-  "commit": "20365c00f7144702c4a7438ac5d907dc97b5b62a",
-  "builtAt": "2026-11-06T20:15:11.914Z"
+  "commit": "437e1e853916beee996b6b16fc2d77f31da0638d",
+  "builtAt": "2026-11-07T00:33:22.871Z"
 };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@replohq/sdk",
-  "version": "2.20.0",
+  "version": "2.20.2",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "2.20.0",
+    "version": "2.20.2",
     "branch": "HEAD",
-    "commit": "20365c00f7144702c4a7438ac5d907dc97b5b62a",
-    "builtAt": "2026-11-06T20:15:11.914Z"
+    "commit": "437e1e853916beee996b6b16fc2d77f31da0638d",
+    "builtAt": "2026-11-07T00:33:22.871Z"
   },
   "description": "Replo SDK — cart, analytics, and data loaders for agent-built Next.js sites.",
   "license": "SEE LICENSE IN LICENSE",
@@ -361,11 +361,7 @@
     "react": ">=18.2.0",
     "react-dom": ">=18.2.0"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/replohq/andytown.git",
-    "directory": "packages/sdk"
-  },
+  "homepage": "https://docs.replo.app/sdk",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"

package/chunk-DMJ5VUD6.mjs

@@ -1,89 +0,0 @@
-import { isString_default, isNumber_default } from './chunk-GNIXARC7.mjs';
-import { isObject_default } from './chunk-JBCOJHZN.mjs';
-
-var has = Object.prototype.hasOwnProperty;
-function dequal(foo, bar) {
-  var ctor, len;
-  if (foo === bar) return true;
-  if (foo && bar && (ctor = foo.constructor) === bar.constructor) {
-    if (ctor === Date) return foo.getTime() === bar.getTime();
-    if (ctor === RegExp) return foo.toString() === bar.toString();
-    if (ctor === Array) {
-      if ((len = foo.length) === bar.length) {
-        while (len-- && dequal(foo[len], bar[len])) ;
-      }
-      return len === -1;
-    }
-    if (!ctor || typeof foo === "object") {
-      len = 0;
-      for (ctor in foo) {
-        if (has.call(foo, ctor) && ++len && !has.call(bar, ctor)) return false;
-        if (!(ctor in bar) || !dequal(foo[ctor], bar[ctor])) return false;
-      }
-      return Object.keys(bar).length === len;
-    }
-  }
-  return foo !== foo && bar !== bar;
-}
-
-function forEachPrimitiveValue({
-  target,
-  fn,
-  valueConversionFunction
-}) {
-  if (!target) {
-    return;
-  }
-  for (const [key, value] of Object.entries(target)) {
-    if (isObject_default(value)) {
-      const newTarget = valueConversionFunction ? valueConversionFunction(value) : value;
-      forEachPrimitiveValue({ target: newTarget, fn });
-    }
-    if (isString_default(value) || isNumber_default(value)) {
-      fn(value, key, target);
-    }
-  }
-}
-function shallowEqual(objA, objB) {
-  if (Object.is(objA, objB)) {
-    return true;
-  }
-  if (typeof objA !== "object" || objA === null || typeof objB !== "object" || objB === null) {
-    return false;
-  }
-  const keysA = Object.keys(objA);
-  const keysB = Object.keys(objB);
-  if (keysA.length !== keysB.length) {
-    return false;
-  }
-  for (let i = 0; i < keysA.length; i++) {
-    const currentKey = keysA[i];
-    if (!Object.hasOwnProperty.call(objB, currentKey) ||
-    !Object.is(objA[currentKey], objB[currentKey])) {
-      return false;
-    }
-  }
-  return true;
-}
-var deepEqual = dequal;
-function omit(obj, keysToOmit) {
-  const result = { ...obj };
-  for (const key of keysToOmit) {
-    delete result[key];
-  }
-  return result;
-}
-function filterUndefined(data) {
-  const result = {};
-  for (const [key, value] of Object.entries(data)) {
-    if (value !== void 0) {
-      result[key] = value;
-    }
-  }
-  return result;
-}
-function toNullableIfDefined(value) {
-  return value === void 0 ? void 0 : value ?? null;
-}
-
-export { deepEqual, filterUndefined, forEachPrimitiveValue, omit, shallowEqual, toNullableIfDefined };

package/chunk-QYGRVXWQ.mjs

@@ -1,32 +0,0 @@
-import { omit } from './chunk-DMJ5VUD6.mjs';
-
-function parseJsonOrNull(json) {
-  try {
-    return JSON.parse(json);
-  } catch {
-    return null;
-  }
-}
-function omitJsonObjectFieldsOrNull({
-  json,
-  fields
-}) {
-  const parsedJson = parseJsonOrNull(json);
-  if (typeof parsedJson !== "object" || parsedJson === null || Array.isArray(parsedJson)) {
-    return null;
-  }
-  const jsonObject = { ...parsedJson };
-  return jsonStringifyOrNull(omit(jsonObject, fields));
-}
-function jsonStringifyOrNull(value) {
-  if (value === null || value === void 0) {
-    return null;
-  }
-  try {
-    return JSON.stringify(value);
-  } catch {
-    return null;
-  }
-}
-
-export { jsonStringifyOrNull, omitJsonObjectFieldsOrNull, parseJsonOrNull };