@rebuy/rebuy 3.24.0 → 3.26.0

package/dist/schema/checkout-and-beyond/index.cjs

@@ -45,6 +45,7 @@ __export(checkout_and_beyond_exports, {
   CABImageSectionFields: () => CABImageSectionFields,
   CABIntegrations: () => CABIntegrations,
   CABLayoutSection: () => CABLayoutSection,
+  CABMonetizeAds: () => CABMonetizeAds,
   CABMonetizeSection: () => CABMonetizeSection,
   CABNumberVariable: () => CABNumberVariable,
   CABOffersSection: () => CABOffersSection,
@@ -1134,8 +1135,14 @@ var CABDiscountSection = import_zod12.z.object({
 // src/schema/widgets/checkout-and-beyond/monetize.ts
 var import_uuid8 = require("uuid");
 var import_zod13 = require("zod");
+var CABMonetizeAds = import_zod13.z.object({
+  requestId: import_zod13.z.string().optional(),
+  /** Defaulted here, never in the beacon: absence of information is `ads` itself being absent. */
+  testing: import_zod13.z.boolean().default(false)
+});
 var CABMonetizeSection = import_zod13.z.object({
   ...CABVariableFields,
+  ads: CABMonetizeAds.optional(),
   name: import_zod13.z.string().optional(),
   /**
    * Server-hydrated offer cards (inline hydration): when `/cab/sections` was asked with a `monetize`

package/dist/schema/checkout-and-beyond/index.mjs

@@ -929,8 +929,14 @@ var CABDiscountSection = z12.object({
 // src/schema/widgets/checkout-and-beyond/monetize.ts
 import { v7 as uuidv78 } from "uuid";
 import { z as z13 } from "zod";
+var CABMonetizeAds = z13.object({
+  requestId: z13.string().optional(),
+  /** Defaulted here, never in the beacon: absence of information is `ads` itself being absent. */
+  testing: z13.boolean().default(false)
+});
 var CABMonetizeSection = z13.object({
   ...CABVariableFields,
+  ads: CABMonetizeAds.optional(),
   name: z13.string().optional(),
   /**
    * Server-hydrated offer cards (inline hydration): when `/cab/sections` was asked with a `monetize`
@@ -1909,6 +1915,7 @@ export {
   CABImageSectionFields,
   CABIntegrations,
   CABLayoutSection,
+  CABMonetizeAds,
   CABMonetizeSection,
   CABNumberVariable,
   CABOffersSection,

package/dist/schema/index.d.ts

@@ -1,6 +1,10 @@
 export * from './cabShopConfig';
 export * from './metadata';
 export * from './offerProduct';
+export * from './postPurchaseEligibility';
+export * from './postPurchaseIdentity';
+export * from './postPurchaseShadow';
+export * from './postPurchaseSkipTrace';
 export * from './product';
 export * from './shopConfig';
 export * from './smartCart';

package/dist/schema/postPurchaseEligibility.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+/**
+ * Why the Decider skipped a candidate. Extracted from the frozen branch's `PostPurchaseOfferEligibility`
+ * union, which also modeled retained product membership (`status: 'retain' | 'unavailable'`, `members`)
+ * — that half is Offer/product-specific and stays out of this Slice. Only the skip-reason vocabulary a
+ * skip trace records travels with the Decision contract.
+ */
+export declare const PostPurchaseSkipReason: z.ZodEnum<{
+    empty: "empty";
+    "no-eligible-subscription": "no-eligible-subscription";
+}>;
+export type PostPurchaseSkipReason = z.infer<typeof PostPurchaseSkipReason>;

package/dist/schema/postPurchaseIdentity.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const PostPurchaseTimestampSchema: z.ZodNumber;
+export declare const PostPurchaseOrderIdSchema: z.ZodString;
+export declare const ShopifyDomainSchema: z.ZodString;
+export declare const DecideRequestSchema: z.ZodObject<{
+    checkoutToken: z.ZodString;
+    shop: z.ZodString;
+}, z.core.$strip>;
+/** A Decision entry: which Flow and node in its tree, which Split (widgetTraffic share) and Widget won. */
+export declare const DecisionEntrySchema: z.ZodObject<{
+    blockId: z.ZodNumber;
+    blockIndex: z.ZodString;
+    blockParentIndex: z.ZodString;
+    flowId: z.ZodNumber;
+    sectionId: z.ZodNumber;
+    widgetId: z.ZodNumber;
+    widgetTraffic: z.ZodNumber;
+}, z.core.$strip>;

package/dist/schema/postPurchaseShadow.d.ts

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+/** Either the Decider found a Widget candidate worth rendering, or it decided to skip. */
+export declare const PostPurchaseShadowSelectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    entry: z.ZodObject<{
+        blockId: z.ZodNumber;
+        blockIndex: z.ZodString;
+        blockParentIndex: z.ZodString;
+        flowId: z.ZodNumber;
+        sectionId: z.ZodNumber;
+        widgetId: z.ZodNumber;
+        widgetTraffic: z.ZodNumber;
+    }, z.core.$strip>;
+    verdict: z.ZodLiteral<"render">;
+}, z.core.$strip>, z.ZodObject<{
+    verdict: z.ZodLiteral<"skip">;
+}, z.core.$strip>], "verdict">;
+export type PostPurchaseShadowSelection = z.infer<typeof PostPurchaseShadowSelectionSchema>;
+/**
+ * A shadow comparison between the legacy client-side selection and the Decider's own — wire-only. The
+ * sampled request/capture shape (`ShadowSampleSchema` upstream, with its Flow-listing and product data)
+ * is not small and stays out of this Slice.
+ */
+export declare const PostPurchaseShadowReportSchema: z.ZodObject<{
+    differences: z.ZodArray<z.ZodEnum<{
+        verdict: "verdict";
+        entry: "entry";
+        targeting: "targeting";
+        "incomplete-capture": "incomplete-capture";
+        "unsupported-configuration": "unsupported-configuration";
+    }>>;
+    legacySelection: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        entry: z.ZodObject<{
+            blockId: z.ZodNumber;
+            blockIndex: z.ZodString;
+            blockParentIndex: z.ZodString;
+            flowId: z.ZodNumber;
+            sectionId: z.ZodNumber;
+            widgetId: z.ZodNumber;
+            widgetTraffic: z.ZodNumber;
+        }, z.core.$strip>;
+        verdict: z.ZodLiteral<"render">;
+    }, z.core.$strip>, z.ZodObject<{
+        verdict: z.ZodLiteral<"skip">;
+    }, z.core.$strip>], "verdict">;
+    phase: z.ZodLiteral<"shouldRender">;
+    sampleId: z.ZodString;
+    serverSelection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        entry: z.ZodObject<{
+            blockId: z.ZodNumber;
+            blockIndex: z.ZodString;
+            blockParentIndex: z.ZodString;
+            flowId: z.ZodNumber;
+            sectionId: z.ZodNumber;
+            widgetId: z.ZodNumber;
+            widgetTraffic: z.ZodNumber;
+        }, z.core.$strip>;
+        verdict: z.ZodLiteral<"render">;
+    }, z.core.$strip>, z.ZodObject<{
+        verdict: z.ZodLiteral<"skip">;
+    }, z.core.$strip>], "verdict">>;
+    status: z.ZodEnum<{
+        match: "match";
+        diverged: "diverged";
+        incomplete: "incomplete";
+    }>;
+    targetingFlowIds: z.ZodArray<z.ZodNumber>;
+    workflowPhase: z.ZodLiteral<"decide">;
+}, z.core.$strip>;
+export type PostPurchaseShadowReport = z.infer<typeof PostPurchaseShadowReportSchema>;

package/dist/schema/postPurchaseSkipTrace.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export declare const POST_PURCHASE_SKIP_LIMIT = 32;
+/** This request's verified reads, not a claim about the path of a competing committed winner. */
+export declare const PostPurchaseSkipTrace: z.ZodArray<z.ZodObject<{
+    entry: z.ZodObject<{
+        blockId: z.ZodNumber;
+        blockIndex: z.ZodString;
+        blockParentIndex: z.ZodString;
+        flowId: z.ZodNumber;
+        sectionId: z.ZodNumber;
+        widgetId: z.ZodNumber;
+        widgetTraffic: z.ZodNumber;
+    }, z.core.$strip>;
+    reason: z.ZodEnum<{
+        empty: "empty";
+        "no-eligible-subscription": "no-eligible-subscription";
+    }>;
+}, z.core.$strip>>;
+export type PostPurchaseSkipTrace = z.infer<typeof PostPurchaseSkipTrace>;

package/dist/schema/widget-data.cjs

@@ -966,8 +966,14 @@ var CABDiscountSection = import_zod15.z.object({
 // src/schema/widgets/checkout-and-beyond/monetize.ts
 var import_uuid8 = require("uuid");
 var import_zod16 = require("zod");
+var CABMonetizeAds = import_zod16.z.object({
+  requestId: import_zod16.z.string().optional(),
+  /** Defaulted here, never in the beacon: absence of information is `ads` itself being absent. */
+  testing: import_zod16.z.boolean().default(false)
+});
 var CABMonetizeSection = import_zod16.z.object({
   ...CABVariableFields,
+  ads: CABMonetizeAds.optional(),
   name: import_zod16.z.string().optional(),
   /**
    * Server-hydrated offer cards (inline hydration): when `/cab/sections` was asked with a `monetize`

package/dist/schema/widget-data.mjs

@@ -941,8 +941,14 @@ var CABDiscountSection = z15.object({
 // src/schema/widgets/checkout-and-beyond/monetize.ts
 import { v7 as uuidv78 } from "uuid";
 import { z as z16 } from "zod";
+var CABMonetizeAds = z16.object({
+  requestId: z16.string().optional(),
+  /** Defaulted here, never in the beacon: absence of information is `ads` itself being absent. */
+  testing: z16.boolean().default(false)
+});
 var CABMonetizeSection = z16.object({
   ...CABVariableFields,
+  ads: CABMonetizeAds.optional(),
   name: z16.string().optional(),
   /**
    * Server-hydrated offer cards (inline hydration): when `/cab/sections` was asked with a `monetize`

package/dist/schema/widgets/checkout-and-beyond/banner.d.ts

@@ -5,6 +5,7 @@ import { type SectionDetails } from './shared';
 export declare const CABBannerSection: z.ZodLazy<z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     width: z.ZodDefault<z.ZodNumber>;
+    sectionId: z.ZodDefault<z.ZodUUID>;
     grid: z.ZodOptional<z.ZodDefault<z.ZodObject<{
         columns: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"fill">, z.ZodString, z.ZodNumber]>>, z.ZodUndefined]>>;
         rows: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"fill">, z.ZodString, z.ZodNumber]>>, z.ZodUndefined]>>;
@@ -29,7 +30,6 @@ export declare const CABBannerSection: z.ZodLazy<z.ZodObject<{
             thick: "thick";
         }>>;
     }, z.core.$strip>>>;
-    sectionId: z.ZodDefault<z.ZodUUID>;
     mutators: z.ZodOptional<z.ZodArray<z.ZodObject<{
         effect: z.ZodDefault<z.ZodEnum<{
             set_false: "set_false";

package/dist/schema/widgets/checkout-and-beyond/carousel.d.ts

@@ -5,6 +5,7 @@ import { CABSection, type SectionDetails } from './shared';
 export declare const CABCarouselSection: z.ZodLazy<z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     width: z.ZodDefault<z.ZodNumber>;
+    sectionId: z.ZodDefault<z.ZodUUID>;
     grid: z.ZodOptional<z.ZodDefault<z.ZodObject<{
         columns: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"fill">, z.ZodString, z.ZodNumber]>>, z.ZodUndefined]>>;
         rows: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"fill">, z.ZodString, z.ZodNumber]>>, z.ZodUndefined]>>;
@@ -54,7 +55,6 @@ export declare const CABCarouselSection: z.ZodLazy<z.ZodObject<{
         switchToSubscriptionNoDiscount: "switchToSubscriptionNoDiscount";
         switchToSubscriptionWithDiscount: "switchToSubscriptionWithDiscount";
     }>>;
-    sectionId: z.ZodDefault<z.ZodUUID>;
     mutators: z.ZodOptional<z.ZodArray<z.ZodObject<{
         effect: z.ZodDefault<z.ZodEnum<{
             set_false: "set_false";

package/dist/schema/widgets/checkout-and-beyond/cartLine.d.ts

@@ -4,6 +4,7 @@ import { CABSection, type SectionDetails } from './shared';
 export declare const CABCartLineSection: z.ZodLazy<z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     width: z.ZodDefault<z.ZodNumber>;
+    sectionId: z.ZodDefault<z.ZodUUID>;
     grid: z.ZodOptional<z.ZodDefault<z.ZodObject<{
         columns: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"fill">, z.ZodString, z.ZodNumber]>>, z.ZodUndefined]>>;
         rows: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"fill">, z.ZodString, z.ZodNumber]>>, z.ZodUndefined]>>;
@@ -53,7 +54,6 @@ export declare const CABCartLineSection: z.ZodLazy<z.ZodObject<{
         switchToSubscriptionNoDiscount: "switchToSubscriptionNoDiscount";
         switchToSubscriptionWithDiscount: "switchToSubscriptionWithDiscount";
     }>>;
-    sectionId: z.ZodDefault<z.ZodUUID>;
     mutators: z.ZodOptional<z.ZodArray<z.ZodObject<{
         effect: z.ZodDefault<z.ZodEnum<{
             set_false: "set_false";

package/dist/schema/widgets/checkout-and-beyond/icons.d.ts

@@ -20,6 +20,7 @@ export declare const IconName: {
     readonly check: "check";
     readonly image: "image";
     readonly discount: "discount";
+    readonly empty: "empty";
     readonly info: "info";
     readonly grid: "grid";
     readonly menu: "menu";
@@ -55,7 +56,6 @@ export declare const IconName: {
     readonly disabled: "disabled";
     readonly edit: "edit";
     readonly email: "email";
-    readonly empty: "empty";
     readonly external: "external";
     readonly geolocation: "geolocation";
     readonly "gift-card": "gift-card";

package/dist/schema/widgets/checkout-and-beyond/image.d.ts

@@ -94,6 +94,7 @@ export declare const CABImageSectionFields: z.ZodObject<{
         check: "check";
         image: "image";
         discount: "discount";
+        empty: "empty";
         info: "info";
         grid: "grid";
         menu: "menu";
@@ -129,7 +130,6 @@ export declare const CABImageSectionFields: z.ZodObject<{
         disabled: "disabled";
         edit: "edit";
         email: "email";
-        empty: "empty";
         external: "external";
         geolocation: "geolocation";
         "gift-card": "gift-card";
@@ -448,6 +448,7 @@ export declare const CABImageSection: z.ZodObject<{
         check: "check";
         image: "image";
         discount: "discount";
+        empty: "empty";
         info: "info";
         grid: "grid";
         menu: "menu";
@@ -483,7 +484,6 @@ export declare const CABImageSection: z.ZodObject<{
         disabled: "disabled";
         edit: "edit";
         email: "email";
-        empty: "empty";
         external: "external";
         geolocation: "geolocation";
         "gift-card": "gift-card";

package/dist/schema/widgets/checkout-and-beyond/monetize.d.ts

@@ -1,7 +1,21 @@
 import { z } from 'zod';
 import { CABSection, type SectionDetails } from './shared';
 import { CABVariableFields } from './variables';
+/**
+ * The ads engine's own verdict on the hydrated request, echoed for the render beacon (REB-24362):
+ * `testing` is server-final (the engine can force it, e.g. an armed offers-testing fixture) and
+ * `requestId` is its `ad_requests` row. Present only alongside hydrated `offers`.
+ */
+export declare const CABMonetizeAds: z.ZodObject<{
+    requestId: z.ZodOptional<z.ZodString>;
+    testing: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CABMonetizeAds = z.infer<typeof CABMonetizeAds>;
 export declare const CABMonetizeSection: z.ZodObject<{
+    ads: z.ZodOptional<z.ZodObject<{
+        requestId: z.ZodOptional<z.ZodString>;
+        testing: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
     name: z.ZodOptional<z.ZodString>;
     offers: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodType<CABSection, unknown, z.core.$ZodTypeInternals<CABSection, unknown>>>>>;
     privacyPolicyUrl: z.ZodOptional<z.ZodString>;
@@ -197,6 +211,7 @@ export declare const CABMonetizeSection: z.ZodObject<{
 }, z.core.$strip>;
 /** Twin of the schema above — `offers` makes this a recursive node (see recursiveTwins.test.ts). */
 export type CABMonetizeSection = CABVariableFields & {
+    ads?: CABMonetizeAds;
     name?: string;
     offers?: CABSection[];
     privacyPolicyUrl?: string;

package/dist/schema/widgets/checkout-and-beyond/offers.d.ts

@@ -4,6 +4,7 @@ import { CABSection, type SectionDetails } from './shared';
 export declare const CABOffersSection: z.ZodLazy<z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     width: z.ZodDefault<z.ZodNumber>;
+    sectionId: z.ZodDefault<z.ZodUUID>;
     grid: z.ZodOptional<z.ZodDefault<z.ZodObject<{
         columns: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"fill">, z.ZodString, z.ZodNumber]>>, z.ZodUndefined]>>;
         rows: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"fill">, z.ZodString, z.ZodNumber]>>, z.ZodUndefined]>>;
@@ -53,7 +54,6 @@ export declare const CABOffersSection: z.ZodLazy<z.ZodObject<{
         switchToSubscriptionNoDiscount: "switchToSubscriptionNoDiscount";
         switchToSubscriptionWithDiscount: "switchToSubscriptionWithDiscount";
     }>>;
-    sectionId: z.ZodDefault<z.ZodUUID>;
     mutators: z.ZodOptional<z.ZodArray<z.ZodObject<{
         effect: z.ZodDefault<z.ZodEnum<{
             set_false: "set_false";

package/dist/schema/widgets/checkout-and-beyond/progressBar.d.ts

@@ -69,6 +69,7 @@ export type CABProgressTier = z.infer<typeof CABProgressTier>;
  */
 export declare const CABProgressBarSection: z.ZodLazy<z.ZodObject<{
     width: z.ZodDefault<z.ZodNumber>;
+    sectionId: z.ZodDefault<z.ZodUUID>;
     grid: z.ZodOptional<z.ZodDefault<z.ZodObject<{
         columns: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"fill">, z.ZodString, z.ZodNumber]>>, z.ZodUndefined]>>;
         rows: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"fill">, z.ZodString, z.ZodNumber]>>, z.ZodUndefined]>>;
@@ -118,7 +119,6 @@ export declare const CABProgressBarSection: z.ZodLazy<z.ZodObject<{
         switchToSubscriptionNoDiscount: "switchToSubscriptionNoDiscount";
         switchToSubscriptionWithDiscount: "switchToSubscriptionWithDiscount";
     }>>;
-    sectionId: z.ZodDefault<z.ZodUUID>;
     mutators: z.ZodOptional<z.ZodArray<z.ZodObject<{
         effect: z.ZodDefault<z.ZodEnum<{
             set_false: "set_false";

package/dist/server/adsEngine.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { type CabUserConfig } from '../schema/cabShopConfig';
+import { type CABMonetizeAds } from '../schema/widgets/checkout-and-beyond/monetize';
 import { type MonetizeInput, type ServerContext } from '../server/shared';
 /**
  * A single ads-engine offer. The `*_url` fields are tracking endpoints the engine returns fully
@@ -35,8 +36,16 @@ export declare const isTestingRequest: (input: MonetizeInput, isProduction: bool
  * (total preferred over subtotal). Empty values are omitted.
  */
 export declare const buildAdsParams: (input: MonetizeInput, publisherKey: string, supplyKey: string, testing: boolean, userAgent?: string, ipAddress?: string) => Record<string, string>;
-/** The engine offers plus the shop's display name (for the header copy), resolved on the same config read. */
+/**
+ * The engine offers plus the shop's display name (for the header copy), resolved on the same config
+ * read, plus `ads` — what the engine decided about the request, for the render beacon to echo verbatim
+ * (REB-24362): `testing` is the engine's response flag OR-ed with the flag we sent (never only our own
+ * rule, because the engine can force it server-side) and `requestId` is its `ad_requests` row id. Present
+ * only once the engine was actually called (absent on every early return, where there is no request to
+ * describe).
+ */
 export type AdsEngineResult = {
+    ads?: CABMonetizeAds;
     offers: AdsEngineOffer[];
     storeName?: string;
 };

package/dist/server/index.cjs

@@ -1579,8 +1579,14 @@ var CABDiscountSection = import_zod19.z.object({
 // src/schema/widgets/checkout-and-beyond/monetize.ts
 var import_uuid8 = require("uuid");
 var import_zod20 = require("zod");
+var CABMonetizeAds = import_zod20.z.object({
+  requestId: import_zod20.z.string().optional(),
+  /** Defaulted here, never in the beacon: absence of information is `ads` itself being absent. */
+  testing: import_zod20.z.boolean().default(false)
+});
 var CABMonetizeSection = import_zod20.z.object({
   ...CABVariableFields,
+  ads: CABMonetizeAds.optional(),
   name: import_zod20.z.string().optional(),
   /**
    * Server-hydrated offer cards (inline hydration): when `/cab/sections` was asked with a `monetize`
@@ -4290,7 +4296,15 @@ var AdsEngineResponse = import_zod28.z.object({
       const result = AdsEngineOffer.safeParse(offer);
       return result.success ? [result.data] : [];
     })
-  )
+  ),
+  /**
+   * Server-decided facts about THIS ads request, echoed so the render beacon can copy them (REB-24362).
+   * `testing` is the engine's final verdict — it can be true when the caller sent false (an armed
+   * offers-testing fixture on a test store forces it, REB-24467). Both optional: an older engine or a
+   * non-JSON body must not fail the parse and drop the offers.
+   */
+  request_id: import_zod28.z.string().optional().catch(void 0),
+  testing: import_zod28.z.boolean().optional().catch(void 0)
 });
 var adsHost = (host) => `offers.${host}`;
 var isTestingRequest = (input, isProduction) => !isProduction || !!input.testing || input.customerEmail?.toLowerCase() === TEST_CUSTOMER_EMAIL;
@@ -4338,19 +4352,21 @@ var fetchAdsEngineOffers = async (input, ctx, prefetched) => {
   if (!publisherKey) return { offers: [], storeName };
   const isProduction = ctx.host === REBUY_ENGINE_HOST;
   const supplyKey = isProduction ? SUPPLY_KEY.production : SUPPLY_KEY.staging;
+  const testing = isTestingRequest(input, isProduction);
   const upstream = await ctx.fetchUpstream(
     "/api/v1/offers",
-    buildAdsParams(
-      input,
-      publisherKey,
-      supplyKey,
-      isTestingRequest(input, isProduction),
-      ctx.userAgent,
-      ctx.ipAddress
-    ),
+    buildAdsParams(input, publisherKey, supplyKey, testing, ctx.userAgent, ctx.ipAddress),
     { host: adsHost(ctx.host) }
   );
-  return { offers: AdsEngineResponse.parse(upstream).offers, storeName };
+  const response = AdsEngineResponse.parse(upstream);
+  return {
+    ads: {
+      ...response.request_id && { requestId: response.request_id },
+      testing: testing || response.testing === true
+    },
+    offers: response.offers,
+    storeName
+  };
 };
 
 // src/transforms/htmlToPlainText.ts
@@ -4549,7 +4565,7 @@ var composeOfferCard = (offer, input, storeName) => {
 
 // src/server/monetizeOffers.ts
 var fetchMonetizeOffers = async (input, ctx, prefetched) => {
-  const { offers: engineOffers, storeName } = await fetchAdsEngineOffers(input, ctx, prefetched);
+  const { ads, offers: engineOffers, storeName } = await fetchAdsEngineOffers(input, ctx, prefetched);
   const composed = engineOffers.map((offer) => composeOfferCard(offer, input, storeName));
   const offers = composed.filter((card) => card !== void 0);
   if (offers.length < composed.length)
@@ -4557,7 +4573,7 @@ var fetchMonetizeOffers = async (input, ctx, prefetched) => {
       detail: `${composed.length - offers.length} monetize offer(s) failed to compose`,
       kind: "monetizeOffer"
     });
-  return { offers };
+  return { ...ads && { ads }, offers };
 };
 
 // src/server/salvageSections.ts
@@ -4651,7 +4667,7 @@ var hydrateMonetizeMarkers = async (converted, input, ctx, config) => {
   const first = findMonetizeMarker(converted);
   if (!first) return;
   try {
-    const { offers } = await fetchMonetizeOffers(
+    const { ads, offers } = await fetchMonetizeOffers(
       {
         ...input.monetize,
         privacyPolicyUrl: first.privacyPolicyUrl,
@@ -4662,6 +4678,7 @@ var hydrateMonetizeMarkers = async (converted, input, ctx, config) => {
       config ?? void 0
     );
     first.offers = offers;
+    if (ads) first.ads = ads;
   } catch (err) {
     ctx.reportDrift?.({
       detail: `inline hydration failed: ${err instanceof Error ? err.message : String(err)}`,

package/dist/server/index.mjs

@@ -1528,8 +1528,14 @@ var CABDiscountSection = z19.object({
 // src/schema/widgets/checkout-and-beyond/monetize.ts
 import { v7 as uuidv78 } from "uuid";
 import { z as z20 } from "zod";
+var CABMonetizeAds = z20.object({
+  requestId: z20.string().optional(),
+  /** Defaulted here, never in the beacon: absence of information is `ads` itself being absent. */
+  testing: z20.boolean().default(false)
+});
 var CABMonetizeSection = z20.object({
   ...CABVariableFields,
+  ads: CABMonetizeAds.optional(),
   name: z20.string().optional(),
   /**
    * Server-hydrated offer cards (inline hydration): when `/cab/sections` was asked with a `monetize`
@@ -4239,7 +4245,15 @@ var AdsEngineResponse = z28.object({
       const result = AdsEngineOffer.safeParse(offer);
       return result.success ? [result.data] : [];
     })
-  )
+  ),
+  /**
+   * Server-decided facts about THIS ads request, echoed so the render beacon can copy them (REB-24362).
+   * `testing` is the engine's final verdict — it can be true when the caller sent false (an armed
+   * offers-testing fixture on a test store forces it, REB-24467). Both optional: an older engine or a
+   * non-JSON body must not fail the parse and drop the offers.
+   */
+  request_id: z28.string().optional().catch(void 0),
+  testing: z28.boolean().optional().catch(void 0)
 });
 var adsHost = (host) => `offers.${host}`;
 var isTestingRequest = (input, isProduction) => !isProduction || !!input.testing || input.customerEmail?.toLowerCase() === TEST_CUSTOMER_EMAIL;
@@ -4287,19 +4301,21 @@ var fetchAdsEngineOffers = async (input, ctx, prefetched) => {
   if (!publisherKey) return { offers: [], storeName };
   const isProduction = ctx.host === REBUY_ENGINE_HOST;
   const supplyKey = isProduction ? SUPPLY_KEY.production : SUPPLY_KEY.staging;
+  const testing = isTestingRequest(input, isProduction);
   const upstream = await ctx.fetchUpstream(
     "/api/v1/offers",
-    buildAdsParams(
-      input,
-      publisherKey,
-      supplyKey,
-      isTestingRequest(input, isProduction),
-      ctx.userAgent,
-      ctx.ipAddress
-    ),
+    buildAdsParams(input, publisherKey, supplyKey, testing, ctx.userAgent, ctx.ipAddress),
     { host: adsHost(ctx.host) }
   );
-  return { offers: AdsEngineResponse.parse(upstream).offers, storeName };
+  const response = AdsEngineResponse.parse(upstream);
+  return {
+    ads: {
+      ...response.request_id && { requestId: response.request_id },
+      testing: testing || response.testing === true
+    },
+    offers: response.offers,
+    storeName
+  };
 };
 
 // src/transforms/htmlToPlainText.ts
@@ -4498,7 +4514,7 @@ var composeOfferCard = (offer, input, storeName) => {
 
 // src/server/monetizeOffers.ts
 var fetchMonetizeOffers = async (input, ctx, prefetched) => {
-  const { offers: engineOffers, storeName } = await fetchAdsEngineOffers(input, ctx, prefetched);
+  const { ads, offers: engineOffers, storeName } = await fetchAdsEngineOffers(input, ctx, prefetched);
   const composed = engineOffers.map((offer) => composeOfferCard(offer, input, storeName));
   const offers = composed.filter((card) => card !== void 0);
   if (offers.length < composed.length)
@@ -4506,7 +4522,7 @@ var fetchMonetizeOffers = async (input, ctx, prefetched) => {
       detail: `${composed.length - offers.length} monetize offer(s) failed to compose`,
       kind: "monetizeOffer"
     });
-  return { offers };
+  return { ...ads && { ads }, offers };
 };
 
 // src/server/salvageSections.ts
@@ -4600,7 +4616,7 @@ var hydrateMonetizeMarkers = async (converted, input, ctx, config) => {
   const first = findMonetizeMarker(converted);
   if (!first) return;
   try {
-    const { offers } = await fetchMonetizeOffers(
+    const { ads, offers } = await fetchMonetizeOffers(
       {
         ...input.monetize,
         privacyPolicyUrl: first.privacyPolicyUrl,
@@ -4611,6 +4627,7 @@ var hydrateMonetizeMarkers = async (converted, input, ctx, config) => {
       config ?? void 0
     );
     first.offers = offers;
+    if (ads) first.ads = ads;
   } catch (err) {
     ctx.reportDrift?.({
       detail: `inline hydration failed: ${err instanceof Error ? err.message : String(err)}`,

package/dist/server/monetizeOffers.d.ts

@@ -1,7 +1,9 @@
 import { type CabUserConfig } from '../schema/cabShopConfig';
-import { type CABSection } from '../schema/widgets/checkout-and-beyond';
+import { type CABMonetizeAds, type CABSection } from '../schema/widgets/checkout-and-beyond';
 import { type MonetizeInput, type ServerContext } from '../server/shared';
+/** Cards plus the engine's own verdict on the request (`ads`), absent when the engine was never called. */
 export type MonetizeOffers = {
+    ads?: CABMonetizeAds;
     offers: CABSection[];
 };
 /**

package/dist/server/requestSchemas.d.ts

@@ -290,6 +290,7 @@ export declare const WidgetSettingsInputSchema: z.ZodObject<{
             }, z.core.$strip>>;
             subtotal: z.ZodNumber;
         }, z.core.$strip>;
+        testing: z.ZodOptional<z.ZodBoolean>;
         country: z.ZodOptional<z.ZodString>;
         customerId: z.ZodOptional<z.ZodString>;
         visitorId: z.ZodOptional<z.ZodString>;
@@ -304,7 +305,6 @@ export declare const WidgetSettingsInputSchema: z.ZodObject<{
             thank_you_page: "thank_you_page";
         }>;
         sessionId: z.ZodOptional<z.ZodString>;
-        testing: z.ZodOptional<z.ZodBoolean>;
         timezone: z.ZodOptional<z.ZodString>;
         transactionId: z.ZodOptional<z.ZodString>;
         transactionItems: z.ZodOptional<z.ZodArray<z.ZodObject<{

package/dist/transforms/index.cjs

@@ -963,8 +963,14 @@ var CABDiscountSection = import_zod13.z.object({
 // src/schema/widgets/checkout-and-beyond/monetize.ts
 var import_uuid8 = require("uuid");
 var import_zod14 = require("zod");
+var CABMonetizeAds = import_zod14.z.object({
+  requestId: import_zod14.z.string().optional(),
+  /** Defaulted here, never in the beacon: absence of information is `ads` itself being absent. */
+  testing: import_zod14.z.boolean().default(false)
+});
 var CABMonetizeSection = import_zod14.z.object({
   ...CABVariableFields,
+  ads: CABMonetizeAds.optional(),
   name: import_zod14.z.string().optional(),
   /**
    * Server-hydrated offer cards (inline hydration): when `/cab/sections` was asked with a `monetize`