@replohq/sdk 2.8.0 → 2.10.0

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

@@ -1,8 +1,14 @@
+type UrlSearchParamValues = Record<string, string | number | boolean | string[] | null | undefined>;
 /**
- * Builds a URLSearchParams from a record, omitting undefined values. Array
- * values are appended as repeated keys; scalars are stringified.
+ * Builds a URLSearchParams from a record, omitting null and undefined values.
+ * Array values are appended as repeated keys; scalars are stringified.
  */
-export declare function buildUrlSearchParams(values: Record<string, string | number | boolean | string[] | undefined>): URLSearchParams;
+export declare function buildUrlSearchParams(values: UrlSearchParamValues): URLSearchParams;
+/**
+ * Appends a query string built by `buildUrlSearchParams` to a path, leaving
+ * the path bare when every value is omitted.
+ */
+export declare function pathWithSearchParams(path: string, values: UrlSearchParamValues): string;
 export declare function isValidHttpUrl(url: string, options?: {
     allowBlockedHostnames?: boolean;
     allowedHostnames?: string[];
@@ -72,3 +78,4 @@ export declare function sanitizePublicHttpUrl(value: string | null, { preservePr
 }): string | null;
 export declare function isPublicHttpsUrl(value: string): boolean;
 export declare function safeHost(url: string): string | null;
+export {};

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" | "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" | "Cookiebot" | "snippet" | "custom" | "consentPlatform";
 export type ConsentCategory = "necessary" | "analytics" | "marketing" | "preferences" | "sale_of_data";
 export type ConsentMode = "off" | "simple" | "per-category";
 export type ScriptTagDescriptor = {
@@ -27,7 +27,7 @@ export type ScriptRuntimeOwner = {
 };
 export type MixpanelRegion = "us" | "eu" | "in";
 export type ReploScriptEntry = {
-    type: "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "HubSpot";
+    type: "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "HubSpot" | "Attentive";
     identifier: string;
     requiredConsent?: ConsentCategory[];
 } | {

package/consent/script-snippets.js

@@ -175,6 +175,16 @@ gtag('config', '${id}');`
         attributes: { id: "hs-script-loader", async: "true", defer: "true" }
       }
     ]
+  },
+  Attentive: {
+    defaultConsent: ["marketing"],
+    buildTags: (id) => [
+      {
+        kind: "external",
+        src: `https://cdn.attn.tv/${id}/dtag.js`,
+        attributes: { async: "true" }
+      }
+    ]
   }
 };
 function isXEventIdForPixel({

package/consent/types.d.ts

@@ -1,4 +1,4 @@
-export type ReploScriptType = "GA4" | "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "X" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "HubSpot" | "Mixpanel" | "Cookiebot" | "snippet" | "custom" | "consentPlatform";
+export type ReploScriptType = "GA4" | "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "X" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "HubSpot" | "Mixpanel" | "Attentive" | "Cookiebot" | "snippet" | "custom" | "consentPlatform";
 export type ConsentCategory = "necessary" | "analytics" | "marketing" | "preferences" | "sale_of_data";
 export type ConsentMode = "off" | "simple" | "per-category";
 declare module "react" {
@@ -36,7 +36,7 @@ export type ScriptRuntimeOwner = {
 };
 export type MixpanelRegion = "us" | "eu" | "in";
 export type ReploScriptEntry = {
-    type: "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "HubSpot";
+    type: "GoogleTagManager" | "Meta" | "TikTok" | "Pinterest" | "Reddit" | "Snapchat" | "Hotjar" | "MicrosoftClarity" | "Contentsquare" | "Segment" | "Northbeam" | "Gorgias" | "Converge" | "HubSpot" | "Attentive";
     identifier: string;
     requiredConsent?: ConsentCategory[];
 } | {

package/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "2.8.0",
+  "version": "2.10.0",
   "branch": "HEAD",
-  "commit": "419304cd8a77ac16dd72b88ad09b17f58b805e11",
-  "builtAt": "2026-10-24T18:15:19.700Z"
+  "commit": "96a07333d34af59c46f8874351df866542e7c2e9",
+  "builtAt": "2026-10-26T22:54:01.502Z"
 };

package/loaders/collection-loader.d.ts

@@ -1,8 +1,11 @@
 import type { ReactNode } from "react";
 import type { CollectionLoaderArgs } from "./collection-loader-args";
+import type { DATA_LOADER_KEYS } from "./loader-keys";
+import type { LoaderKeyProp } from "./loader-outputs";
 import type { FullCollection } from "./loader-schemas";
+type LoaderKey = (typeof DATA_LOADER_KEYS)["SHOPIFY_COLLECTION"];
 type CollectionLoaderProps = CollectionLoaderArgs & {
-    loaderKey: string;
+    loaderKey: LoaderKeyProp<LoaderKey>;
     children: (data: FullCollection) => ReactNode;
     fallback?: ReactNode;
 };

package/loaders/collection-loader.js

@@ -13,15 +13,11 @@ function CollectionLoaderInner({
 }) {
   const queryResult = useSuspenseQuery({
     queryKey: [loaderKey, args],
-    queryFn: async () => {
-      const [loadedData, schemas] = await Promise.all([
-        invokeLoader({
-          loaderKey,
-          args
-        }),
-        import("./loader-schemas")
-      ]);
-      return schemas.fullCollectionSchema.parse(loadedData);
+    queryFn: () => {
+      return invokeLoader({
+        loaderKey,
+        args
+      });
     }
   });
   useReportPreviewPlaceholderRender(queryResult.data);

package/loaders/collection-products-loader.d.ts

@@ -1,8 +1,11 @@
 import type { ReactNode } from "react";
 import type { CollectionProductsLoaderArgs } from "./collection-products-loader-args";
+import type { DATA_LOADER_KEYS } from "./loader-keys";
+import type { LoaderKeyProp } from "./loader-outputs";
 import type { PaginatedProducts } from "./loader-schemas";
+type LoaderKey = (typeof DATA_LOADER_KEYS)["SHOPIFY_COLLECTION_PRODUCTS"];
 type CollectionProductsLoaderProps = CollectionProductsLoaderArgs & {
-    loaderKey: string;
+    loaderKey: LoaderKeyProp<LoaderKey>;
     children: (data: PaginatedProducts) => ReactNode;
     fallback?: ReactNode;
 };

package/loaders/collection-products-loader.js

@@ -13,15 +13,11 @@ function CollectionProductsLoaderInner({
 }) {
   const queryResult = useSuspenseQuery({
     queryKey: [loaderKey, args],
-    queryFn: async () => {
-      const [loadedData, schemas] = await Promise.all([
-        invokeLoader({
-          loaderKey,
-          args
-        }),
-        import("./loader-schemas")
-      ]);
-      return schemas.paginatedProductsSchema.parse(loadedData);
+    queryFn: () => {
+      return invokeLoader({
+        loaderKey,
+        args
+      });
     }
   });
   useReportPreviewPlaceholderRender(queryResult.data);

package/loaders/contentful-entries-loader.d.ts

@@ -1,7 +1,10 @@
 import type { ReactNode } from "react";
+import type { DATA_LOADER_KEYS } from "./loader-keys";
+import type { LoaderKeyProp } from "./loader-outputs";
 import type { ContentfulEntriesLoaderOutput } from "./loader-schemas";
+type LoaderKey = (typeof DATA_LOADER_KEYS)["CONTENTFUL_ENTRIES"];
 type ContentfulEntriesLoaderProps = {
-    loaderKey: string;
+    loaderKey: LoaderKeyProp<LoaderKey>;
     spaceId: string;
     contentType: string;
     environmentId?: string;

package/loaders/contentful-entries-loader.js

@@ -32,12 +32,8 @@ function ContentfulEntriesLoaderInner({
 }) {
   const { data } = useSuspenseQuery({
     queryKey: [loaderKey, args],
-    queryFn: async () => {
-      const [loadedData, schemas] = await Promise.all([
-        invokeLoader({ loaderKey, args }),
-        import("./loader-schemas")
-      ]);
-      return schemas.contentfulEntriesLoaderOutputSchema.parse(loadedData);
+    queryFn: () => {
+      return invokeLoader({ loaderKey, args });
     }
   });
   return /* @__PURE__ */ jsx(Fragment, { children: children(data) });

package/loaders/contentful-entry-loader.d.ts

@@ -1,7 +1,10 @@
 import type { ReactNode } from "react";
+import type { DATA_LOADER_KEYS } from "./loader-keys";
+import type { LoaderKeyProp } from "./loader-outputs";
 import type { ContentfulEntryLoaderOutput } from "./loader-schemas";
+type LoaderKey = (typeof DATA_LOADER_KEYS)["CONTENTFUL_ENTRY"];
 type ContentfulEntryLoaderProps = {
-    loaderKey: string;
+    loaderKey: LoaderKeyProp<LoaderKey>;
     spaceId: string;
     entryId: string;
     environmentId?: string;

package/loaders/contentful-entry-loader.js

@@ -26,12 +26,8 @@ function ContentfulEntryLoaderInner({
 }) {
   const { data } = useSuspenseQuery({
     queryKey: [loaderKey, args],
-    queryFn: async () => {
-      const [loadedData, schemas] = await Promise.all([
-        invokeLoader({ loaderKey, args }),
-        import("./loader-schemas")
-      ]);
-      return schemas.contentfulEntryLoaderOutputSchema.parse(loadedData);
+    queryFn: () => {
+      return invokeLoader({ loaderKey, args });
     }
   });
   return /* @__PURE__ */ jsx(Fragment, { children: children(data) });

package/loaders/invoke-loader-action.d.ts

@@ -3,7 +3,8 @@
  * Called from client-side loader components when React Query needs to
  * fetch data in the browser (e.g., client-side navigation, cache miss).
  * This runs on the server — Next.js handles the client/server boundary
- * automatically.
+ * automatically. The output is validated here, before it crosses to the
+ * browser.
  */
 export declare function invokeLoaderAction({ loaderKey, args, }: {
     loaderKey: string;

package/loaders/invoke-loader-action.js

@@ -1,12 +1,10 @@
 "use server";
-import { getCanopyApiGateway } from "../gateways/canopy-api";
+import { fetchValidatedLoaderOutput } from "./loader-output";
 async function invokeLoaderAction({
   loaderKey,
   args
 }) {
-  const gateway = await getCanopyApiGateway();
-  const response = await gateway.invokeLoader({ loaderKey, args });
-  return response.data;
+  return fetchValidatedLoaderOutput({ loaderKey, args });
 }
 export {
   invokeLoaderAction

package/loaders/invoke-loader-server.js

@@ -1,9 +1,9 @@
 import { unstable_cache } from "next/cache";
 import {
   CanopyApiGatewayError,
-  getCanopyApiGateway,
   shouldIncludeInactiveProducts
 } from "../gateways/canopy-api";
+import { fetchValidatedLoaderOutput, LoaderOutputError } from "./loader-output";
 import { resolvePreviewPlaceholderData } from "./preview-placeholder";
 const DEFAULT_REVALIDATE_SECONDS = 60;
 class LoaderDataNotFoundError extends CanopyApiGatewayError {
@@ -46,11 +46,15 @@ async function invokeLoaderServer({
   });
   const cachedInvocation = await unstable_cache(
     async () => {
-      const gateway = await getCanopyApiGateway();
       try {
-        const response = await gateway.invokeLoader({ loaderKey, args });
-        return { kind: "data", data: response.data };
+        return {
+          kind: "data",
+          data: await fetchValidatedLoaderOutput({ loaderKey, args })
+        };
       } catch (error) {
+        if (error instanceof LoaderOutputError) {
+          return { kind: "data", data: error.unvalidatedOutput };
+        }
         if (error instanceof CanopyApiGatewayError && error.statusCode === 404) {
           return { kind: "notFound" };
         }

package/loaders/invoke-loader.d.ts

@@ -1,3 +1,5 @@
+import type { DataLoaderKey } from "./loader-keys";
+import type { LoaderKeyProp, LoaderOutput } from "./loader-outputs";
 import { CanopyError } from "../lib/canopy-error";
 /** Scoped error for loader invocation failures. */
 export declare class LoaderInvokeError extends CanopyError {
@@ -7,6 +9,12 @@ export declare class LoaderInvokeError extends CanopyError {
  * In the browser, dynamically imports a server action so React 19 never sees
  * the "use server" reference during render.
  *
+ * `Key` names the loader the caller expects, and the result is typed from it.
+ * It is not checked here: `loaderKey` can be any string a site passed to a
+ * component, and the server validates the output against the schema
+ * registered for the key actually sent (`loader-output.ts`), so the browser
+ * never downloads Zod or the schemas. Callers pass `Key` explicitly.
+ *
  * Next defines `process.env.NEXT_RUNTIME` as "" in browser bundles, so the
  * bundler drops the server branch and never emits the gateway, its env
  * handling, or its Zod schemas as a client chunk. `typeof window` is not
@@ -15,7 +23,7 @@ export declare class LoaderInvokeError extends CanopyError {
  * In an editor iframe previewing an unfilled dynamic route, returns sample
  * data instead of fetching — see `preview-placeholder.ts`.
  */
-export declare function invokeLoader({ loaderKey, args, }: {
-    loaderKey: string;
+export declare function invokeLoader<Key extends DataLoaderKey>(params: {
+    loaderKey: LoaderKeyProp<Key>;
     args: Record<string, unknown>;
-}): Promise<unknown>;
+}): Promise<LoaderOutput<Key>>;

package/loaders/invoke-loader.js

@@ -2,7 +2,7 @@ import { CanopyError } from "../lib/canopy-error";
 import { resolvePreviewPlaceholderData } from "./preview-placeholder";
 class LoaderInvokeError extends CanopyError {
 }
-async function invokeLoader({
+async function invokeUntypedLoader({
   loaderKey,
   args
 }) {
@@ -12,10 +12,8 @@ async function invokeLoader({
   }
   try {
     if (process.env.NEXT_RUNTIME) {
-      const { getCanopyApiGateway } = await import("../gateways/canopy-api");
-      const gateway = await getCanopyApiGateway();
-      const response = await gateway.invokeLoader({ loaderKey, args });
-      return response.data;
+      const { fetchValidatedLoaderOutput } = await import("./loader-output");
+      return await fetchValidatedLoaderOutput({ loaderKey, args });
     }
     const { invokeLoaderAction } = await import("./invoke-loader-action");
     return await invokeLoaderAction({ loaderKey, args });
@@ -30,6 +28,9 @@ async function invokeLoader({
     });
   }
 }
+async function invokeLoader(params) {
+  return await invokeUntypedLoader(params);
+}
 export {
   LoaderInvokeError,
   invokeLoader

package/loaders/judgeme-review-aggregate-loader.d.ts

@@ -1,9 +1,12 @@
 import type { ReactNode } from "react";
 import type { z } from "zod";
+import type { DATA_LOADER_KEYS } from "./loader-keys";
+import type { LoaderKeyProp } from "./loader-outputs";
 import type { judgemeProductReviewAggregateLoaderOutputSchema } from "./loader-schemas";
+type LoaderKey = (typeof DATA_LOADER_KEYS)["JUDGEME_PRODUCT_REVIEW_AGGREGATE"];
 type JudgemeReviewAggregateData = z.infer<typeof judgemeProductReviewAggregateLoaderOutputSchema>;
 type JudgemeReviewAggregateLoaderProps = {
-    loaderKey: string;
+    loaderKey: LoaderKeyProp<LoaderKey>;
     productId: string;
     children: (data: JudgemeReviewAggregateData) => ReactNode;
     fallback?: ReactNode;

package/loaders/judgeme-review-aggregate-loader.js

@@ -11,17 +11,11 @@ function JudgemeReviewAggregateLoaderInner({
 }) {
   const { data } = useSuspenseQuery({
     queryKey: [loaderKey, { productId }],
-    queryFn: async () => {
-      const [loadedData, schemas] = await Promise.all([
-        invokeLoader({
-          loaderKey,
-          args: { productId }
-        }),
-        import("./loader-schemas")
-      ]);
-      return schemas.judgemeProductReviewAggregateLoaderOutputSchema.parse(
-        loadedData
-      );
+    queryFn: () => {
+      return invokeLoader({
+        loaderKey,
+        args: { productId }
+      });
     }
   });
   return /* @__PURE__ */ jsx(Fragment, { children: children(data) });

package/loaders/judgeme-reviews-loader.d.ts

@@ -1,9 +1,12 @@
 import type { ReactNode } from "react";
 import type { z } from "zod";
+import type { DATA_LOADER_KEYS } from "./loader-keys";
+import type { LoaderKeyProp } from "./loader-outputs";
 import type { judgemeProductReviewsLoaderOutputSchema } from "./loader-schemas";
+type LoaderKey = (typeof DATA_LOADER_KEYS)["JUDGEME_PRODUCT_REVIEWS"];
 type JudgemeReviewsData = z.infer<typeof judgemeProductReviewsLoaderOutputSchema>;
 type JudgemeReviewsLoaderProps = {
-    loaderKey: string;
+    loaderKey: LoaderKeyProp<LoaderKey>;
     productId: string;
     perPage?: number;
     page?: number;

package/loaders/judgeme-reviews-loader.js

@@ -25,12 +25,8 @@ function JudgemeReviewsLoaderInner({
   const args = buildReviewsArgs({ productId, perPage, page });
   const { data } = useSuspenseQuery({
     queryKey: [loaderKey, args],
-    queryFn: async () => {
-      const [loadedData, schemas] = await Promise.all([
-        invokeLoader({ loaderKey, args }),
-        import("./loader-schemas")
-      ]);
-      return schemas.judgemeProductReviewsLoaderOutputSchema.parse(loadedData);
+    queryFn: () => {
+      return invokeLoader({ loaderKey, args });
     }
   });
   return /* @__PURE__ */ jsx(Fragment, { children: children(data) });

package/loaders/junip-review-aggregate-loader.d.ts

@@ -1,9 +1,12 @@
 import type { ReactNode } from "react";
 import type { z } from "zod";
+import type { DATA_LOADER_KEYS } from "./loader-keys";
+import type { LoaderKeyProp } from "./loader-outputs";
 import type { junipProductReviewAggregateLoaderOutputSchema } from "./loader-schemas";
+type LoaderKey = (typeof DATA_LOADER_KEYS)["JUNIP_PRODUCT_REVIEW_AGGREGATE"];
 type JunipReviewAggregateData = z.infer<typeof junipProductReviewAggregateLoaderOutputSchema>;
 type JunipReviewAggregateLoaderProps = {
-    loaderKey: string;
+    loaderKey: LoaderKeyProp<LoaderKey>;
     productId: string;
     children: (data: JunipReviewAggregateData) => ReactNode;
     fallback?: ReactNode;

package/loaders/junip-review-aggregate-loader.js

@@ -11,17 +11,11 @@ function JunipReviewAggregateLoaderInner({
 }) {
   const { data } = useSuspenseQuery({
     queryKey: [loaderKey, { productId }],
-    queryFn: async () => {
-      const [loadedData, schemas] = await Promise.all([
-        invokeLoader({
-          loaderKey,
-          args: { productId }
-        }),
-        import("./loader-schemas")
-      ]);
-      return schemas.junipProductReviewAggregateLoaderOutputSchema.parse(
-        loadedData
-      );
+    queryFn: () => {
+      return invokeLoader({
+        loaderKey,
+        args: { productId }
+      });
     }
   });
   return /* @__PURE__ */ jsx(Fragment, { children: children(data) });

package/loaders/junip-reviews-loader.d.ts

@@ -1,9 +1,12 @@
 import type { ReactNode } from "react";
 import type { z } from "zod";
+import type { DATA_LOADER_KEYS } from "./loader-keys";
+import type { LoaderKeyProp } from "./loader-outputs";
 import type { junipProductReviewsLoaderOutputSchema } from "./loader-schemas";
+type LoaderKey = (typeof DATA_LOADER_KEYS)["JUNIP_PRODUCT_REVIEWS"];
 type JunipReviewsData = z.infer<typeof junipProductReviewsLoaderOutputSchema>;
 type JunipReviewsLoaderProps = {
-    loaderKey: string;
+    loaderKey: LoaderKeyProp<LoaderKey>;
     productId: string;
     perPage?: number;
     children: (data: JunipReviewsData) => ReactNode;

package/loaders/junip-reviews-loader.js

@@ -19,12 +19,8 @@ function JunipReviewsLoaderInner({
   const args = buildReviewsArgs({ productId, perPage });
   const { data } = useSuspenseQuery({
     queryKey: [loaderKey, args],
-    queryFn: async () => {
-      const [loadedData, schemas] = await Promise.all([
-        invokeLoader({ loaderKey, args }),
-        import("./loader-schemas")
-      ]);
-      return schemas.junipProductReviewsLoaderOutputSchema.parse(loadedData);
+    queryFn: () => {
+      return invokeLoader({ loaderKey, args });
     }
   });
   return /* @__PURE__ */ jsx(Fragment, { children: children(data) });

package/loaders/kaching-bundles-loader.d.ts

@@ -1,7 +1,10 @@
 import type { ReactNode } from "react";
 import type { AddToCartItem } from "../cart/hooks/use-add-to-cart";
+import type { DATA_LOADER_KEYS } from "./loader-keys";
+import type { LoaderKeyProp } from "./loader-outputs";
+type LoaderKey = (typeof DATA_LOADER_KEYS)["SHOPIFY_KACHING_BUNDLES"];
 type KachingBundlesLoaderProps = {
-    loaderKey: string;
+    loaderKey: LoaderKeyProp<LoaderKey>;
     productId: string;
     dealBlockId?: string;
     country?: string;

package/loaders/kaching-bundles-loader.js

@@ -15,12 +15,11 @@ function KachingBundlesLoaderInner({
   const [lines, setLines] = useState([]);
   const { data } = useSuspenseQuery({
     queryKey: [loaderKey, args],
-    queryFn: async () => {
-      const [loadedData, schemas] = await Promise.all([
-        invokeLoader({ loaderKey, args }),
-        import("./loader-schemas")
-      ]);
-      return schemas.shopifyKachingBundlesLoaderOutputSchema.parse(loadedData);
+    queryFn: () => {
+      return invokeLoader({
+        loaderKey,
+        args
+      });
     }
   });
   if (data.bundles === null) {

package/loaders/levanta-product-loader.d.ts

@@ -1,7 +1,10 @@
 import type { ReactNode } from "react";
+import type { DATA_LOADER_KEYS } from "./loader-keys";
+import type { LoaderKeyProp } from "./loader-outputs";
 import type { LevantaProductFull } from "./loader-schemas";
+type LoaderKey = (typeof DATA_LOADER_KEYS)["LEVANTA_PRODUCT"];
 type LevantaProductLoaderProps = {
-    loaderKey: string;
+    loaderKey: LoaderKeyProp<LoaderKey>;
     asin: string;
     marketplace?: string;
     children: (data: LevantaProductFull) => ReactNode;

package/loaders/levanta-product-loader.js

@@ -12,15 +12,11 @@ function LevantaProductLoaderInner({
 }) {
   const queryResult = useSuspenseQuery({
     queryKey: [loaderKey, { asin, marketplace }],
-    queryFn: async () => {
-      const [loadedData, schemas] = await Promise.all([
-        invokeLoader({
-          loaderKey,
-          args: { asin, marketplace }
-        }),
-        import("./loader-schemas")
-      ]);
-      return schemas.levantaProductFullSchema.parse(loadedData);
+    queryFn: () => {
+      return invokeLoader({
+        loaderKey,
+        args: { asin, marketplace }
+      });
     }
   });
   return /* @__PURE__ */ jsx(Fragment, { children: children(queryResult.data) });

package/loaders/loader-output.d.ts

@@ -0,0 +1,28 @@
+import type { DataLoaderKey } from "./loader-keys";
+import * as z from "zod";
+import { CanopyError } from "../lib/canopy-error";
+/**
+ * A loader returned data that does not match its output contract. Carries the
+ * unvalidated output so a caller that fails soft can still serve it.
+ */
+export declare class LoaderOutputError extends CanopyError {
+    readonly unvalidatedOutput: unknown;
+    constructor({ loaderKey, unvalidatedOutput, zodError, }: {
+        loaderKey: DataLoaderKey;
+        unvalidatedOutput: unknown;
+        zodError: z.ZodError;
+    });
+}
+/**
+ * Invokes a loader through the canopy-api gateway and validates its output
+ * against the loader's contract. The parsed value drops fields the contract
+ * does not declare. Output of a loader key the SDK has no contract for passes
+ * through unchanged.
+ *
+ * Malformed output is logged with the loader key and the failing paths, then
+ * rejected with a `LoaderOutputError`; callers decide whether to fail soft.
+ */
+export declare function fetchValidatedLoaderOutput({ loaderKey, args, }: {
+    loaderKey: string;
+    args: Record<string, unknown>;
+}): Promise<unknown>;