@rebuy/rebuy 3.24.0 → 3.25.0

package/dist/index.cjs

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

package/dist/index.mjs

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

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/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/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/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`

package/dist/transforms/index.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rebuy/rebuy",
-    "version": "3.24.0",
+    "version": "3.25.0",
     "description": "Shared zod schemas, legacy-to-CAB widget transforms, and server orchestrators for Rebuy's Shopify consumers (rebuy-api, admin-nextjs, rebuy-shopify-extensions)",
     "license": "MIT",
     "author": "Rebuy, Inc.",