@replohq/sdk 1.18.0 → 1.19.0

package/_vendor/schemas/routing/locale.d.ts

@@ -25,8 +25,8 @@ export declare const localeRoutingConfigSchema: z.ZodObject<{
         language: "language";
     }>>;
     urlMode: z.ZodDefault<z.ZodEnum<{
-        prefixed: "prefixed";
         hidden: "hidden";
+        prefixed: "prefixed";
     }>>;
     domains: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         locales: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;

package/integrations/mailchimp.d.ts

@@ -0,0 +1,65 @@
+import React from "react";
+import { z } from "zod";
+import { CanopyError } from "../lib/canopy-error";
+declare const mailchimpSubscribeErrorCodeSchema: z.ZodEnum<{
+    notConnected: "notConnected";
+    listNotFound: "listNotFound";
+    invalidEmail: "invalidEmail";
+    invalidRequest: "invalidRequest";
+    emailNotSubscribable: "emailNotSubscribable";
+    mergeFieldsInvalid: "mergeFieldsInvalid";
+    rateLimited: "rateLimited";
+    upstreamError: "upstreamError";
+}>;
+/** `pending` means Mailchimp emailed a confirmation link the visitor must click. */
+export type MailchimpSubscribeStatus = "subscribed" | "pending";
+export type MailchimpSubscribeErrorCode = z.infer<typeof mailchimpSubscribeErrorCodeSchema>;
+export declare class MailchimpSubscribeError extends CanopyError {
+    readonly code: MailchimpSubscribeErrorCode;
+    constructor({ code, message, cause, }: {
+        code: MailchimpSubscribeErrorCode;
+        message: string;
+        cause: unknown;
+    });
+}
+/**
+ * Adds an opted-in email to a Mailchimp audience from a published Replo form.
+ * Call it in a client component under `ReploProvider`, render
+ * `<input {...honeypotFieldProps} />` inside the form, and submit with
+ * `subscribe.mutate({ email, mergeFields, interests })`. The project id comes
+ * from the site, not the caller.
+ *
+ * `tags` label everyone this form adds (e.g. `["waitlist-spring"]`), `event`
+ * records a custom event that can start a Mailchimp Customer Journey, and
+ * `interests` opts the visitor into audience groups by id. All three apply
+ * only to people new to the audience.
+ *
+ * `subscribe.error` is a `MailchimpSubscribeError`; branch on its `code`.
+ */
+export declare function useMailchimpSubscribe({ listId, tags, event, }: {
+    listId: string;
+    tags: string[] | null;
+    event: string | null;
+}): {
+    subscribe: import("@tanstack/react-query").UseMutationResult<MailchimpSubscribeStatus, MailchimpSubscribeError, {
+        email: string;
+        mergeFields: Record<string, string> | null;
+        interests: Record<string, boolean> | null;
+    }, unknown>;
+    honeypotFieldProps: {
+        name: string;
+        value: string;
+        onChange: (event: React.ChangeEvent<HTMLInputElement>) => void;
+        tabIndex: number;
+        autoComplete: "off";
+        "aria-hidden": true;
+        style: {
+            position: "absolute";
+            left: string;
+            width: string;
+            height: string;
+            overflow: "hidden";
+        };
+    };
+};
+export {};

package/integrations/mailchimp.js

@@ -0,0 +1,133 @@
+"use client";
+import React from "react";
+import { useMutation } from "@tanstack/react-query";
+import { parseJsonOrNull } from "../_vendor/replo-utils/lib/json.mjs";
+import { z } from "zod";
+import { CanopyError } from "../lib/canopy-error";
+import { useCanopyClientConfig } from "../providers/canopy-client-config";
+const mailchimpSubscribeErrorCodeSchema = z.enum([
+  "notConnected",
+  "listNotFound",
+  "invalidEmail",
+  "invalidRequest",
+  "emailNotSubscribable",
+  "mergeFieldsInvalid",
+  "rateLimited",
+  "upstreamError"
+]);
+const mailchimpSubscribeResponseSchema = z.discriminatedUnion("ok", [
+  z.object({
+    ok: z.literal(true),
+    status: z.enum(["subscribed", "pending"])
+  }),
+  z.object({
+    ok: z.literal(false),
+    error: z.object({
+      code: mailchimpSubscribeErrorCodeSchema,
+      message: z.string()
+    })
+  })
+]);
+class MailchimpSubscribeError extends CanopyError {
+  code;
+  constructor({
+    code,
+    message,
+    cause
+  }) {
+    super({ message, cause, additionalData: { code } });
+    this.code = code;
+  }
+}
+async function postSubscribe({
+  config,
+  request
+}) {
+  if (!config) {
+    throw new MailchimpSubscribeError({
+      code: "upstreamError",
+      message: "This site has no canopy-api config, so it cannot reach Mailchimp",
+      cause: null
+    });
+  }
+  let responseText;
+  try {
+    const response = await fetch(
+      `${config.canopyApiBaseUrl}/api/v1/integrations/mailchimp/subscribe`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ projectId: config.projectId, ...request })
+      }
+    );
+    responseText = await response.text();
+  } catch (error) {
+    throw new MailchimpSubscribeError({
+      code: "upstreamError",
+      message: "Could not reach the Mailchimp subscribe endpoint",
+      cause: error
+    });
+  }
+  const parsed = mailchimpSubscribeResponseSchema.safeParse(
+    parseJsonOrNull(responseText)
+  );
+  if (!parsed.success) {
+    throw new MailchimpSubscribeError({
+      code: "upstreamError",
+      message: "The Mailchimp subscribe endpoint returned an unexpected response",
+      cause: parsed.error
+    });
+  }
+  if (!parsed.data.ok) {
+    throw new MailchimpSubscribeError({ ...parsed.data.error, cause: null });
+  }
+  return parsed.data.status;
+}
+function useMailchimpSubscribe({
+  listId,
+  tags,
+  event
+}) {
+  const config = useCanopyClientConfig();
+  const [renderedAtMilliseconds] = React.useState(() => Date.now());
+  const [honeypot, setHoneypot] = React.useState("");
+  const subscribe = useMutation({
+    mutationFn: ({ email, mergeFields, interests }) => {
+      return postSubscribe({
+        config,
+        request: {
+          listId,
+          email,
+          mergeFields,
+          tags,
+          interests,
+          event,
+          honeypot,
+          elapsedMilliseconds: Date.now() - renderedAtMilliseconds
+        }
+      });
+    }
+  });
+  const honeypotFieldProps = {
+    name: "company_website",
+    value: honeypot,
+    onChange: (event2) => {
+      setHoneypot(event2.target.value);
+    },
+    tabIndex: -1,
+    autoComplete: "off",
+    "aria-hidden": true,
+    style: {
+      position: "absolute",
+      left: "-10000px",
+      width: "1px",
+      height: "1px",
+      overflow: "hidden"
+    }
+  };
+  return { subscribe, honeypotFieldProps };
+}
+export {
+  MailchimpSubscribeError,
+  useMailchimpSubscribe
+};

package/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "branch": "HEAD",
-  "commit": "038932591fc729ca2f66cb29af15af8573ff9fd0",
-  "builtAt": "2026-10-14T19:30:38.623Z"
+  "commit": "e3b248dbf12d7b2d1f401d36170686e094d40e3a",
+  "builtAt": "2026-10-14T22:19:29.297Z"
 };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@replohq/sdk",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "1.18.0",
+    "version": "1.19.0",
     "branch": "HEAD",
-    "commit": "038932591fc729ca2f66cb29af15af8573ff9fd0",
-    "builtAt": "2026-10-14T19:30:38.623Z"
+    "commit": "e3b248dbf12d7b2d1f401d36170686e094d40e3a",
+    "builtAt": "2026-10-14T22:19:29.297Z"
   },
   "description": "Replo SDK — cart, analytics, and data loaders for agent-built Next.js sites.",
   "license": "SEE LICENSE IN LICENSE",
@@ -77,6 +77,10 @@
       "types": "./hooks/use-formatted-price.d.ts",
       "default": "./hooks/use-formatted-price.js"
     },
+    "./integrations/mailchimp": {
+      "types": "./integrations/mailchimp.d.ts",
+      "default": "./integrations/mailchimp.js"
+    },
     "./lib/buildMetadata": {
       "types": "./lib/buildMetadata.d.ts",
       "default": "./lib/buildMetadata.js"

package/providers/canopy-client-config.d.ts

@@ -0,0 +1,14 @@
+import React from "react";
+/**
+ * What browser code needs to call canopy-api directly. Resolved from the worker
+ * env by `ReploProvider`; null when the env can't be read (e.g. outside the
+ * worker), in which case browser calls fail with a typed error.
+ */
+export type CanopyClientConfig = {
+    canopyApiBaseUrl: string;
+    projectId: string;
+};
+export declare function CanopyClientConfigProvider({ config, children, }: React.PropsWithChildren<{
+    config: CanopyClientConfig | null;
+}>): import("react/jsx-runtime").JSX.Element;
+export declare function useCanopyClientConfig(): CanopyClientConfig | null;

package/providers/canopy-client-config.js

@@ -0,0 +1,17 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import React from "react";
+const CanopyClientConfigContext = React.createContext(null);
+function CanopyClientConfigProvider({
+  config,
+  children
+}) {
+  return /* @__PURE__ */ jsx(CanopyClientConfigContext.Provider, { value: config, children });
+}
+function useCanopyClientConfig() {
+  return React.useContext(CanopyClientConfigContext);
+}
+export {
+  CanopyClientConfigProvider,
+  useCanopyClientConfig
+};

package/providers/replo-provider.js

@@ -2,21 +2,29 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import { AnalyticsProvider } from "../analytics/analytics-provider";
 import { ReploFirstPartyPixel } from "../analytics/replo-first-party-pixel";
 import { CartLoader } from "../cart/cart-loader";
-import { getCheckoutProvider } from "../lib/integration-utils";
+import { getEnv } from "../env";
+import { buildBaseUrl } from "../lib/url-utils";
 import { LoaderErrorDetailsProvider } from "../loaders/loader-error-boundary";
 import { shouldShowLoaderErrorDetails } from "../loaders/loader-error-details";
+import { CanopyClientConfigProvider } from "./canopy-client-config";
 import { QueryProvider } from "./query-provider";
 async function ReploProvider({
   children,
   markets
 }) {
   let checkoutProvider = "none";
+  let canopyClientConfig = null;
   try {
-    checkoutProvider = await getCheckoutProvider();
+    const env = await getEnv();
+    checkoutProvider = env.CHECKOUT_PROVIDER ?? "none";
+    canopyClientConfig = {
+      canopyApiBaseUrl: buildBaseUrl(env.CANOPY_API_HOST),
+      projectId: env.PROJECT_ID
+    };
   } catch {
     checkoutProvider = "none";
   }
-  return /* @__PURE__ */ jsx(QueryProvider, { children: /* @__PURE__ */ jsx(LoaderErrorDetailsProvider, { enabled: shouldShowLoaderErrorDetails(), children: /* @__PURE__ */ jsxs(AnalyticsProvider, { checkoutProvider, children: [
+  return /* @__PURE__ */ jsx(QueryProvider, { children: /* @__PURE__ */ jsx(CanopyClientConfigProvider, { config: canopyClientConfig, children: /* @__PURE__ */ jsx(LoaderErrorDetailsProvider, { enabled: shouldShowLoaderErrorDetails(), children: /* @__PURE__ */ jsxs(AnalyticsProvider, { checkoutProvider, children: [
     /* @__PURE__ */ jsx(ReploFirstPartyPixel, {}),
     /* @__PURE__ */ jsx(
       CartLoader,
@@ -26,7 +34,7 @@ async function ReploProvider({
         children
       }
     )
-  ] }) }) });
+  ] }) }) }) });
 }
 export {
   ReploProvider