@replohq/sdk 2.18.0 → 2.18.1

package/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "2.18.0",
+  "version": "2.18.1",
   "branch": "HEAD",
-  "commit": "aa9296f4104e4be2271247d775a27fa69288bbe8",
-  "builtAt": "2026-11-02T03:31:48.722Z"
+  "commit": "31098580021d6a05449acd44d0850054eec6e0ec",
+  "builtAt": "2026-11-02T23:35:33.205Z"
 };

package/loaders/loader-args.d.ts

@@ -0,0 +1,15 @@
+import { CanopyError } from "../lib/canopy-error";
+/** A loader argument that can't be sent to canopy-api, such as a function. */
+export declare class LoaderArgsError extends CanopyError {
+}
+/**
+ * Finds the first function in a loader's args. JSON drops functions silently,
+ * so canopy-api would receive the args without that key and reject them. The
+ * usual cause is a value exported from a "use client" file and imported into a
+ * server component: on the server, every such export is a client reference
+ * (a function), never the value itself.
+ */
+export declare function getLoaderArgsError({ loaderKey, args, }: {
+    loaderKey: string;
+    args: Record<string, unknown>;
+}): LoaderArgsError | null;

package/loaders/loader-args.js

@@ -0,0 +1,46 @@
+import { CanopyError } from "../lib/canopy-error";
+const CLIENT_REFERENCE_TAG = Symbol.for("react.client.reference");
+class LoaderArgsError extends CanopyError {
+}
+function findFunctionArg(value, path, seen) {
+  if (typeof value === "function") {
+    return {
+      path,
+      isClientReference: Reflect.get(value, "$$typeof") === CLIENT_REFERENCE_TAG
+    };
+  }
+  if (typeof value !== "object" || value === null || seen.has(value) || typeof Reflect.get(value, "toJSON") === "function") {
+    return null;
+  }
+  seen.add(value);
+  for (const [key, child] of Object.entries(value)) {
+    const childPath = Array.isArray(value) ? `${path}[${key}]` : `${path}.${key}`;
+    const found = findFunctionArg(child, childPath, seen);
+    if (found !== null) {
+      return found;
+    }
+  }
+  return null;
+}
+function getLoaderArgsError({
+  loaderKey,
+  args
+}) {
+  const found = findFunctionArg(args, "args", /* @__PURE__ */ new Set());
+  if (found === null) {
+    return null;
+  }
+  const what = found.isClientReference ? "a client reference, not a value" : "a function";
+  return new LoaderArgsError({
+    message: `[Replo] Loader ${loaderKey}: ${found.path} is ${what}, so it can't be sent to the loader. It was probably imported from a "use client" file into a server component. Move the value into a module without "use client" and import it from both places.`,
+    additionalData: {
+      loaderKey,
+      path: found.path,
+      isClientReference: found.isClientReference
+    }
+  });
+}
+export {
+  LoaderArgsError,
+  getLoaderArgsError
+};

package/loaders/loader-output.d.ts

@@ -21,6 +21,9 @@ export declare class LoaderOutputError extends CanopyError {
  *
  * Malformed output is logged with the loader key and the failing paths, then
  * rejected with a `LoaderOutputError`; callers decide whether to fail soft.
+ * Args holding a function are logged and rejected with a `LoaderArgsError`
+ * before any request, since JSON would drop them and canopy-api would reject
+ * the rest. The log matters because `PrefetchedLoaders` swallows rejections.
  */
 export declare function fetchValidatedLoaderOutput({ loaderKey, args, }: {
     loaderKey: string;

package/loaders/loader-output.js

@@ -9,6 +9,7 @@ import {
   smileRewardsOutputSchema,
   smileVipTiersOutputSchema
 } from "./integration-loader-schemas";
+import { getLoaderArgsError } from "./loader-args";
 import { DATA_LOADER_KEYS } from "./loader-keys";
 import {
   contentfulEntriesLoaderOutputSchema,
@@ -93,6 +94,11 @@ async function fetchValidatedLoaderOutput({
   loaderKey,
   args
 }) {
+  const argsError = getLoaderArgsError({ loaderKey, args });
+  if (argsError !== null) {
+    console.error(argsError.message);
+    throw argsError;
+  }
   const gateway = await getCanopyApiGateway();
   const { data } = await gateway.invokeLoader({ loaderKey, args });
   const knownKey = dataLoaderKeySchema.safeParse(loaderKey);

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@replohq/sdk",
-  "version": "2.18.0",
+  "version": "2.18.1",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "2.18.0",
+    "version": "2.18.1",
     "branch": "HEAD",
-    "commit": "aa9296f4104e4be2271247d775a27fa69288bbe8",
-    "builtAt": "2026-11-02T03:31:48.722Z"
+    "commit": "31098580021d6a05449acd44d0850054eec6e0ec",
+    "builtAt": "2026-11-02T23:35:33.205Z"
   },
   "description": "Replo SDK — cart, analytics, and data loaders for agent-built Next.js sites.",
   "license": "SEE LICENSE IN LICENSE",