@rebuy/rebuy 3.56.3 → 3.57.0

package/dist/server/classifyPostPurchaseOffer.d.ts

@@ -1,5 +1,8 @@
 import { type z } from 'zod';
 import { type PostPurchaseOfferEligibility, PostPurchaseOfferEligibilityContext, PostPurchaseStsOptions } from '../schema/postPurchaseOfferEligibility';
+import type { Reporter } from '../server/shared';
 export declare const classifyPostPurchaseOffer: (settings: unknown, response: unknown, context: z.input<typeof PostPurchaseOfferEligibilityContext>, 
 /** STS opt-in; absent or `{ sts: false }` keeps every pre-STS outcome. */
-options?: PostPurchaseStsOptions) => PostPurchaseOfferEligibility;
+options?: PostPurchaseStsOptions, 
+/** Hears each purchased STS candidate whose plan data cannot be read, once per response (REB-25050). */
+report?: Reporter) => PostPurchaseOfferEligibility;

package/dist/server/index.cjs

@@ -6172,17 +6172,30 @@ var PostPurchaseProductSettings = PostPurchaseSettings.pick({
 
 // src/server/readPostPurchaseProductSource.ts
 var import_zod45 = require("zod");
-var Envelope = PostPurchaseProductSource.extend({ data: import_zod45.z.array(import_zod45.z.unknown()) });
-var Product3 = PostPurchaseProductSource.shape.data.element;
-var Identified = import_zod45.z.object({ id: PostPurchaseProductId });
+
+// src/server/postPurchaseResponseDrift.ts
 var heard = /* @__PURE__ */ new WeakMap();
-var firstHearing = (response, report) => {
-  const reporters = heard.get(response) ?? /* @__PURE__ */ new WeakSet();
+var sources = /* @__PURE__ */ new WeakMap();
+var rememberPostPurchaseProductSource = (product, response, productIndex) => {
+  sources.set(product, { productIndex, response });
+};
+var postPurchaseProductSourceOf = (product) => sources.get(product);
+var reportOncePerResponse = (response, report, events) => {
+  const reporters = heard.get(response) ?? /* @__PURE__ */ new WeakMap();
   heard.set(response, reporters);
-  if (reporters.has(report)) return false;
-  reporters.add(report);
-  return true;
+  const details = reporters.get(report) ?? /* @__PURE__ */ new Set();
+  reporters.set(report, details);
+  for (const event of events) {
+    if (details.has(event.detail)) continue;
+    details.add(event.detail);
+    report(event);
+  }
 };
+
+// src/server/readPostPurchaseProductSource.ts
+var Envelope = PostPurchaseProductSource.extend({ data: import_zod45.z.array(import_zod45.z.unknown()) });
+var Product3 = PostPurchaseProductSource.shape.data.element;
+var Identified = import_zod45.z.object({ id: PostPurchaseProductId });
 var readPostPurchaseProductSource = (response, report) => {
   const { data, metadata } = Envelope.parse(deepCamelCase(response));
   const drift = [];
@@ -6190,6 +6203,7 @@ var readPostPurchaseProductSource = (response, report) => {
   const products = data.flatMap((raw, productIndex) => {
     const parsed = Product3.safeParse(raw);
     if (parsed.success) {
+      rememberPostPurchaseProductSource(parsed.data, response, productIndex);
       if (parsed.data.requiresSellingPlan && !parsed.data.sellingPlanGroups.length)
         drift.push({
           detail: `Dropped post-purchase product ${parsed.data.id}: data.${productIndex}.requiresSellingPlan`,
@@ -6207,7 +6221,7 @@ var readPostPurchaseProductSource = (response, report) => {
     });
     return [];
   });
-  if (report && drift.length && firstHearing(response, report)) drift.forEach((event) => report(event));
+  if (report && drift.length) reportOncePerResponse(response, report, drift);
   return { dropped, metadata, products };
 };
 
@@ -6353,7 +6367,8 @@ var Groups = import_zod52.z.array(
     sellingPlans: import_zod52.z.unknown()
   })
 );
-var Allocations = import_zod52.z.array(import_zod52.z.object({ sellingPlanGroupId: import_zod52.z.string().min(1) })).default([]);
+var PostPurchasePlanAllocations = import_zod52.z.array(import_zod52.z.object({ sellingPlanGroupId: import_zod52.z.string().min(1) }));
+var Allocations = PostPurchasePlanAllocations.default([]);
 var Plans = import_zod52.z.array(
   PostPurchasePlanOption.pick({ id: true, name: true }).extend({
     options: import_zod52.z.array(import_zod52.z.object({ value: import_zod52.z.string().min(1) })).min(1),
@@ -7624,18 +7639,30 @@ var readPostPurchaseQuantity = ({
 
 // src/server/postPurchaseSts.ts
 var stsAllowed = ({ effective, original }) => [original, effective].some((config) => config.upgradeToSubscription.allow);
-var postPurchaseStsLine = (normalized, product, lines, variantId) => {
+var reportUnreadableStsLine = (product, field, report) => {
+  const source2 = postPurchaseProductSourceOf(product);
+  const path = source2 ? `data.${source2.productIndex}.${field}` : field;
+  const detail = `Unreadable post-purchase STS product ${product.id}: ${path}`;
+  reportOncePerResponse(source2?.response ?? product, report, [{ detail, kind: "product" }]);
+};
+var postPurchaseStsLine = (normalized, product, lines, variantId, report) => {
   if (!product.sellingPlanGroups?.length || product.productGroupVariants.length) return void 0;
-  for (const variant2 of product.variants) {
+  const modern = typeof product.sellingPlanGroups[0].id !== "number";
+  for (const [index, variant2] of product.variants.entries()) {
     const matched = lines.filter((line) => line.sellingPlanId === void 0 && line.variantId === variant2.id);
     const data = [{ ...product, variants: [variant2] }];
-    if ((variantId === void 0 || variant2.id === variantId) && matched.length === 1 && postPurchaseVariantAvailable(variant2) && projectPostPurchasePlanCatalog({ ...normalized, data })?.plans.length)
-      return { data, line: matched[0] };
+    if ((variantId === void 0 || variant2.id === variantId) && matched.length === 1 && postPurchaseVariantAvailable(variant2)) {
+      const unread = [];
+      if (projectPostPurchasePlanCatalog({ ...normalized, data }, (event) => unread.push(event))?.plans.length)
+        return { data, line: matched[0] };
+      const field = modern && !PostPurchasePlanAllocations.safeParse(variant2.sellingPlanAllocations).success ? `variants.${index}.sellingPlanAllocations` : unread.length ? "sellingPlanGroups" : void 0;
+      if (report && field) reportUnreadableStsLine(product, field, report);
+    }
   }
 };
 var preparePostPurchaseStsView = (widgetId, normalized, product, context, requested, report) => {
   const { originalLineItems } = PostPurchaseStsContext.parse(context);
-  const found = postPurchaseStsLine(normalized, product, originalLineItems, requested.variantId);
+  const found = postPurchaseStsLine(normalized, product, originalLineItems, requested.variantId, report);
   if (!found) return null;
   const whole = found.line.quantity;
   if (requested.quantity !== void 0 && requested.quantity !== whole)
@@ -8097,7 +8124,7 @@ var postPurchaseMemberEligibility = (normalized, product, excluded) => {
 
 // src/server/classifyPostPurchaseOffer.ts
 var identities = (members) => members.map(({ product, productIndex }) => ({ productId: product.id, productIndex }));
-var classifyPostPurchaseOffer = (settings, response, context, options2) => {
+var classifyPostPurchaseOffer = (settings, response, context, options2, report) => {
   let unreadable = "context-unreadable";
   try {
     const trusted = PostPurchaseOfferEligibilityContext.parse(context);
@@ -8123,7 +8150,7 @@ var classifyPostPurchaseOffer = (settings, response, context, options2) => {
       PostPurchaseSubscriptionSettings.parse(normalized.effective.subscription);
     }
     const lines = trusted.originalLineItems;
-    const stsMembers = sts ? members.filter(({ product }) => postPurchaseStsLine(normalized, product, lines)) : [];
+    const stsMembers = sts ? members.filter(({ product }) => postPurchaseStsLine(normalized, product, lines, void 0, report)) : [];
     if (stsMembers.length) return { members: identities(stsMembers), mode: "sts", status: "retain" };
     const classified = members.map((member) => ({
       ...member,

package/dist/server/index.mjs

@@ -6099,17 +6099,30 @@ var PostPurchaseProductSettings = PostPurchaseSettings.pick({
 
 // src/server/readPostPurchaseProductSource.ts
 import { z as z45 } from "zod";
-var Envelope = PostPurchaseProductSource.extend({ data: z45.array(z45.unknown()) });
-var Product3 = PostPurchaseProductSource.shape.data.element;
-var Identified = z45.object({ id: PostPurchaseProductId });
+
+// src/server/postPurchaseResponseDrift.ts
 var heard = /* @__PURE__ */ new WeakMap();
-var firstHearing = (response, report) => {
-  const reporters = heard.get(response) ?? /* @__PURE__ */ new WeakSet();
+var sources = /* @__PURE__ */ new WeakMap();
+var rememberPostPurchaseProductSource = (product, response, productIndex) => {
+  sources.set(product, { productIndex, response });
+};
+var postPurchaseProductSourceOf = (product) => sources.get(product);
+var reportOncePerResponse = (response, report, events) => {
+  const reporters = heard.get(response) ?? /* @__PURE__ */ new WeakMap();
   heard.set(response, reporters);
-  if (reporters.has(report)) return false;
-  reporters.add(report);
-  return true;
+  const details = reporters.get(report) ?? /* @__PURE__ */ new Set();
+  reporters.set(report, details);
+  for (const event of events) {
+    if (details.has(event.detail)) continue;
+    details.add(event.detail);
+    report(event);
+  }
 };
+
+// src/server/readPostPurchaseProductSource.ts
+var Envelope = PostPurchaseProductSource.extend({ data: z45.array(z45.unknown()) });
+var Product3 = PostPurchaseProductSource.shape.data.element;
+var Identified = z45.object({ id: PostPurchaseProductId });
 var readPostPurchaseProductSource = (response, report) => {
   const { data, metadata } = Envelope.parse(deepCamelCase(response));
   const drift = [];
@@ -6117,6 +6130,7 @@ var readPostPurchaseProductSource = (response, report) => {
   const products = data.flatMap((raw, productIndex) => {
     const parsed = Product3.safeParse(raw);
     if (parsed.success) {
+      rememberPostPurchaseProductSource(parsed.data, response, productIndex);
       if (parsed.data.requiresSellingPlan && !parsed.data.sellingPlanGroups.length)
         drift.push({
           detail: `Dropped post-purchase product ${parsed.data.id}: data.${productIndex}.requiresSellingPlan`,
@@ -6134,7 +6148,7 @@ var readPostPurchaseProductSource = (response, report) => {
     });
     return [];
   });
-  if (report && drift.length && firstHearing(response, report)) drift.forEach((event) => report(event));
+  if (report && drift.length) reportOncePerResponse(response, report, drift);
   return { dropped, metadata, products };
 };
 
@@ -6280,7 +6294,8 @@ var Groups = z52.array(
     sellingPlans: z52.unknown()
   })
 );
-var Allocations = z52.array(z52.object({ sellingPlanGroupId: z52.string().min(1) })).default([]);
+var PostPurchasePlanAllocations = z52.array(z52.object({ sellingPlanGroupId: z52.string().min(1) }));
+var Allocations = PostPurchasePlanAllocations.default([]);
 var Plans = z52.array(
   PostPurchasePlanOption.pick({ id: true, name: true }).extend({
     options: z52.array(z52.object({ value: z52.string().min(1) })).min(1),
@@ -7551,18 +7566,30 @@ var readPostPurchaseQuantity = ({
 
 // src/server/postPurchaseSts.ts
 var stsAllowed = ({ effective, original }) => [original, effective].some((config) => config.upgradeToSubscription.allow);
-var postPurchaseStsLine = (normalized, product, lines, variantId) => {
+var reportUnreadableStsLine = (product, field, report) => {
+  const source2 = postPurchaseProductSourceOf(product);
+  const path = source2 ? `data.${source2.productIndex}.${field}` : field;
+  const detail = `Unreadable post-purchase STS product ${product.id}: ${path}`;
+  reportOncePerResponse(source2?.response ?? product, report, [{ detail, kind: "product" }]);
+};
+var postPurchaseStsLine = (normalized, product, lines, variantId, report) => {
   if (!product.sellingPlanGroups?.length || product.productGroupVariants.length) return void 0;
-  for (const variant2 of product.variants) {
+  const modern = typeof product.sellingPlanGroups[0].id !== "number";
+  for (const [index, variant2] of product.variants.entries()) {
     const matched = lines.filter((line) => line.sellingPlanId === void 0 && line.variantId === variant2.id);
     const data = [{ ...product, variants: [variant2] }];
-    if ((variantId === void 0 || variant2.id === variantId) && matched.length === 1 && postPurchaseVariantAvailable(variant2) && projectPostPurchasePlanCatalog({ ...normalized, data })?.plans.length)
-      return { data, line: matched[0] };
+    if ((variantId === void 0 || variant2.id === variantId) && matched.length === 1 && postPurchaseVariantAvailable(variant2)) {
+      const unread = [];
+      if (projectPostPurchasePlanCatalog({ ...normalized, data }, (event) => unread.push(event))?.plans.length)
+        return { data, line: matched[0] };
+      const field = modern && !PostPurchasePlanAllocations.safeParse(variant2.sellingPlanAllocations).success ? `variants.${index}.sellingPlanAllocations` : unread.length ? "sellingPlanGroups" : void 0;
+      if (report && field) reportUnreadableStsLine(product, field, report);
+    }
   }
 };
 var preparePostPurchaseStsView = (widgetId, normalized, product, context, requested, report) => {
   const { originalLineItems } = PostPurchaseStsContext.parse(context);
-  const found = postPurchaseStsLine(normalized, product, originalLineItems, requested.variantId);
+  const found = postPurchaseStsLine(normalized, product, originalLineItems, requested.variantId, report);
   if (!found) return null;
   const whole = found.line.quantity;
   if (requested.quantity !== void 0 && requested.quantity !== whole)
@@ -8024,7 +8051,7 @@ var postPurchaseMemberEligibility = (normalized, product, excluded) => {
 
 // src/server/classifyPostPurchaseOffer.ts
 var identities = (members) => members.map(({ product, productIndex }) => ({ productId: product.id, productIndex }));
-var classifyPostPurchaseOffer = (settings, response, context, options2) => {
+var classifyPostPurchaseOffer = (settings, response, context, options2, report) => {
   let unreadable = "context-unreadable";
   try {
     const trusted = PostPurchaseOfferEligibilityContext.parse(context);
@@ -8050,7 +8077,7 @@ var classifyPostPurchaseOffer = (settings, response, context, options2) => {
       PostPurchaseSubscriptionSettings.parse(normalized.effective.subscription);
     }
     const lines = trusted.originalLineItems;
-    const stsMembers = sts ? members.filter(({ product }) => postPurchaseStsLine(normalized, product, lines)) : [];
+    const stsMembers = sts ? members.filter(({ product }) => postPurchaseStsLine(normalized, product, lines, void 0, report)) : [];
     if (stsMembers.length) return { members: identities(stsMembers), mode: "sts", status: "retain" };
     const classified = members.map((member) => ({
       ...member,

package/dist/server/postPurchaseModernPlans.d.ts

@@ -1,4 +1,9 @@
+import { z } from 'zod';
 import { PostPurchasePlanOption } from '../schema/postPurchasePlanCatalog';
+/** A variant's readable `selling_plan_allocations`; a missing list reads as none here, but STS reports it. */
+export declare const PostPurchasePlanAllocations: z.ZodArray<z.ZodObject<{
+    sellingPlanGroupId: z.ZodString;
+}, z.core.$strip>>;
 /**
  * Match allocation groups in product order, then preserve each matching group's plan order. Membership is
  * group-level by design (frozen-branch parity): Shopify allocates every plan of a group to a member variant, and

package/dist/server/postPurchaseResponseDrift.d.ts

@@ -0,0 +1,13 @@
+import type { Reporter, ServerDrift } from '../server/shared';
+/** Records where a parsed product came from, so drift found about it later still names its response and path. */
+export declare const rememberPostPurchaseProductSource: (product: object, response: object, productIndex: number) => void;
+/** The response and raw `productIndex` a parsed product was read from, when it was read by the product source. */
+export declare const postPurchaseProductSourceOf: (product: object) => {
+    productIndex: number;
+    response: object;
+} | undefined;
+/**
+ * Reports each event `report` has not yet heard about `response`, keyed on the `response` object itself: every
+ * projection of one request rereads the same object, so a drift is heard once however many projections find it.
+ */
+export declare const reportOncePerResponse: (response: object, report: Reporter, events: ServerDrift[]) => void;

package/dist/server/postPurchaseSts.d.ts

@@ -18,8 +18,14 @@ export declare const stsAllowed: ({ effective, original }: Pick<Normalized, "eff
  * product is never an STS member; (4) the bound variant is the purchased line's, not the product's selected
  * variant, and subscription is the only mode. The first such variant in catalog order wins, unless `variantId`
  * names one.
+ *
+ * `report` hears a candidate (a purchased, in-stock variant on exactly one one-time line) whose plan data cannot be
+ * read, since it then silently switches nothing: a modern selling-plan variant whose `sellingPlanAllocations` is
+ * missing or malformed, or plan data the catalog cannot read. Each is a `product` drift naming the product id and
+ * the dotted path from the source root, never a value, heard once per response like the source's own drops. A
+ * readable variant that simply has no plan, or no candidate at all, stays silent.
  */
-export declare const postPurchaseStsLine: <T extends Line>(normalized: Normalized, product: Normalized["data"][number], lines: T[], variantId?: number) => {
+export declare const postPurchaseStsLine: <T extends Line>(normalized: Normalized, product: Normalized["data"][number], lines: T[], variantId?: number, report?: Reporter) => {
     data: {
         variants: {
             title: string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rebuy/rebuy",
-    "version": "3.56.3",
+    "version": "3.57.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.",