@rebuy/rebuy 3.55.0 → 3.56.0

package/dist/server/normalizePostPurchaseProduct.d.ts

@@ -257,7 +257,22 @@ export declare const normalizePostPurchaseSource: (settings: unknown, response:
         productIndex: number;
     }[];
 };
-/** Both prepared purchase terms and display structure consume this one effective configuration. */
+/**
+ * `productLimit` caps raw positions: keep only the entries whose raw `productIndex` sits under the cap, so a
+ * product the schema dropped leaves its slot empty rather than promoting a survivor past the cap.
+ */
+export declare const underPostPurchaseCap: <T extends {
+    productIndex: number;
+}>(entries: T[], cap: number) => T[];
+/**
+ * Both prepared purchase terms and display structure consume this one effective configuration. A product past
+ * the effective `productLimit` is never the one prepared: when no product under the cap survived salvage, `data`
+ * is empty (as the collection keeps no member), so `[bad, good]` with a limit of 1 prepares nothing. Otherwise
+ * `data` keeps every survivor, so a source with more than one readable product still reads as ambiguous rather
+ * than having products discarded. Each dropped product, past the cap or not, was already reported as drift.
+ * A limit under 1 is a configuration fault, not a cap: `data` stays whole so eligibility rejects it with the
+ * configuration reason instead of the catalog reporting drift for a readable product.
+ */
 export declare const normalizePostPurchaseProduct: (settings: unknown, response: unknown, report?: Reporter) => {
     data: {
         title: string;

package/dist/server/postPurchaseCardSections.d.ts

@@ -2,9 +2,9 @@ import { normalizePostPurchaseProduct } from '../server/normalizePostPurchasePro
 import type { Reporter } from '../server/shared';
 /**
  * The product's section tree from the effective settings snapshot, or `null` unless it holds exactly one product
- * card. No product values enter the tree; the client resolves its tokens.
+ * card. No product values enter the tree; the client resolves its tokens. An STS card (`sts`) gets STS copy.
  */
-export declare const postPurchaseCardSections: (widgetId: number, { effective, metadata }: Pick<ReturnType<typeof normalizePostPurchaseProduct>, "effective" | "metadata">, report?: Reporter) => import("..").CABRootSection | null;
+export declare const postPurchaseCardSections: (widgetId: number, { effective: configured, metadata, }: Pick<ReturnType<typeof normalizePostPurchaseProduct>, "effective" | "metadata">, report?: Reporter, sts?: boolean) => import("..").CABRootSection | null;
 /**
  * The same tree from the raw settings and data-source response, for a caller's own choice-level fallback — rebuy-api's
  * group default that resolves no available merchandise.

package/dist/server/postPurchaseSts.d.ts

@@ -143,6 +143,7 @@ export declare const preparePostPurchaseStsView: (widgetId: number, normalized:
                         amount: number;
                         type: "price" | "fixed_amount" | "percentage";
                     } | undefined;
+                    sts?: true | undefined;
                 } | undefined;
             };
             display: {
@@ -452,6 +453,7 @@ export declare const preparePostPurchaseStsView: (widgetId: number, normalized:
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {
@@ -660,6 +662,7 @@ export declare const preparePostPurchaseStsView: (widgetId: number, normalized:
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {
@@ -751,6 +754,7 @@ export declare const prepareStsCollectionMember: (widgetId: number, normalized:
                         amount: number;
                         type: "price" | "fixed_amount" | "percentage";
                     } | undefined;
+                    sts?: true | undefined;
                 } | undefined;
             };
             display: {
@@ -1060,6 +1064,7 @@ export declare const prepareStsCollectionMember: (widgetId: number, normalized:
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {
@@ -1268,6 +1273,7 @@ export declare const prepareStsCollectionMember: (widgetId: number, normalized:
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {

package/dist/server/prepareNormalizedSubscription.d.ts

@@ -5,6 +5,7 @@ import type { PostPurchaseQuantity } from '../server/readPostPurchaseQuantity';
 import type { Reporter } from '../server/shared';
 /**
  * Preparation for one allocated plan with validated configured shipping and discount; `report` receives
- * unreadable-review drift.
+ * unreadable-review drift. A switch to subscription (STS) charges no initial shipping, only the recurring
+ * shipping (legacy `useSubscriptionPurchaseOptions`, L112/L122).
  */
 export declare const prepareNormalizedSubscription: (normalized: ReturnType<typeof normalizePostPurchaseProduct>, report: Reporter | undefined, plan: PostPurchasePlanOption | undefined, quantity?: PostPurchaseQuantity, allowCollection?: boolean) => PostPurchasePreparation;

package/dist/server/preparePostPurchaseAdmissionView.d.ts

@@ -64,6 +64,7 @@ export declare const preparePostPurchaseAdmissionView: (widgetId: number, settin
                         amount: number;
                         type: "price" | "fixed_amount" | "percentage";
                     } | undefined;
+                    sts?: true | undefined;
                 } | undefined;
             };
             display: {
@@ -373,6 +374,7 @@ export declare const preparePostPurchaseAdmissionView: (widgetId: number, settin
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {
@@ -581,6 +583,7 @@ export declare const preparePostPurchaseAdmissionView: (widgetId: number, settin
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {

package/dist/server/preparePostPurchaseCollectionGroup.d.ts

@@ -104,6 +104,7 @@ export declare const preparePostPurchaseCollectionGroup: (widgetId: number, sett
                         amount: number;
                         type: "price" | "fixed_amount" | "percentage";
                     } | undefined;
+                    sts?: true | undefined;
                 } | undefined;
             };
             display: {
@@ -383,6 +384,7 @@ export declare const preparePostPurchaseCollectionGroup: (widgetId: number, sett
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {
@@ -592,6 +594,7 @@ export declare const preparePostPurchaseCollectionGroup: (widgetId: number, sett
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {

package/dist/server/preparePostPurchaseCollectionView.d.ts

@@ -89,6 +89,7 @@ sts?: PostPurchaseStsContext) => {
                             amount: number;
                             type: "price" | "fixed_amount" | "percentage";
                         } | undefined;
+                        sts?: true | undefined;
                     } | undefined;
                 };
                 display: {
@@ -398,6 +399,7 @@ sts?: PostPurchaseStsContext) => {
                 modes: ("one-time" | "subscription")[];
                 selector: "radio" | "dropdown";
             } | undefined;
+            sts?: true | undefined;
             variantCatalog?: {
                 displayMode: "single" | "separate";
                 options: {
@@ -606,6 +608,7 @@ sts?: PostPurchaseStsContext) => {
                 modes: ("one-time" | "subscription")[];
                 selector: "radio" | "dropdown";
             } | undefined;
+            sts?: true | undefined;
             variantCatalog?: {
                 displayMode: "single" | "separate";
                 options: {

package/dist/server/preparePostPurchaseGroupAdmissionView.d.ts

@@ -112,6 +112,7 @@ export declare const preparePostPurchaseGroupAdmissionView: (widgetId: number, s
                         amount: number;
                         type: "price" | "fixed_amount" | "percentage";
                     } | undefined;
+                    sts?: true | undefined;
                 } | undefined;
             };
             display: {
@@ -421,6 +422,7 @@ export declare const preparePostPurchaseGroupAdmissionView: (widgetId: number, s
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {
@@ -629,6 +631,7 @@ export declare const preparePostPurchaseGroupAdmissionView: (widgetId: number, s
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {

package/dist/server/preparePostPurchaseGroupDefault.d.ts

@@ -68,6 +68,7 @@ export declare const preparePostPurchaseGroupDefault: (widgetId: number, setting
                         amount: number;
                         type: "price" | "fixed_amount" | "percentage";
                     } | undefined;
+                    sts?: true | undefined;
                 } | undefined;
             };
             display: {
@@ -374,6 +375,7 @@ export declare const preparePostPurchaseGroupDefault: (widgetId: number, setting
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {
@@ -582,6 +584,7 @@ export declare const preparePostPurchaseGroupDefault: (widgetId: number, setting
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {

package/dist/server/preparePostPurchaseGroupView.d.ts

@@ -111,6 +111,7 @@ export declare const preparePostPurchaseGroupView: (widgetId: number, settings:
                         amount: number;
                         type: "price" | "fixed_amount" | "percentage";
                     } | undefined;
+                    sts?: true | undefined;
                 } | undefined;
             };
             display: {
@@ -420,6 +421,7 @@ export declare const preparePostPurchaseGroupView: (widgetId: number, settings:
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {
@@ -628,6 +630,7 @@ export declare const preparePostPurchaseGroupView: (widgetId: number, settings:
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {

package/dist/server/preparePostPurchaseMemberView.d.ts

@@ -68,6 +68,7 @@ export declare const prepareMember: (widgetId: number, settings: unknown, respon
                             amount: number;
                             type: "price" | "fixed_amount" | "percentage";
                         } | undefined;
+                        sts?: true | undefined;
                     } | undefined;
                 };
                 display: {
@@ -377,6 +378,7 @@ export declare const prepareMember: (widgetId: number, settings: unknown, respon
                 modes: ("one-time" | "subscription")[];
                 selector: "radio" | "dropdown";
             } | undefined;
+            sts?: true | undefined;
             variantCatalog?: {
                 displayMode: "single" | "separate";
                 options: {
@@ -585,6 +587,7 @@ export declare const prepareMember: (widgetId: number, settings: unknown, respon
                 modes: ("one-time" | "subscription")[];
                 selector: "radio" | "dropdown";
             } | undefined;
+            sts?: true | undefined;
             variantCatalog?: {
                 displayMode: "single" | "separate";
                 options: {
@@ -881,6 +884,7 @@ export declare const prepareMember: (widgetId: number, settings: unknown, respon
                             amount: number;
                             type: "price" | "fixed_amount" | "percentage";
                         } | undefined;
+                        sts?: true | undefined;
                     } | undefined;
                 };
                 display: {
@@ -1190,6 +1194,7 @@ export declare const prepareMember: (widgetId: number, settings: unknown, respon
                 modes: ("one-time" | "subscription")[];
                 selector: "radio" | "dropdown";
             } | undefined;
+            sts?: true | undefined;
             variantCatalog?: {
                 displayMode: "single" | "separate";
                 options: {
@@ -1398,6 +1403,7 @@ export declare const prepareMember: (widgetId: number, settings: unknown, respon
                 modes: ("one-time" | "subscription")[];
                 selector: "radio" | "dropdown";
             } | undefined;
+            sts?: true | undefined;
             variantCatalog?: {
                 displayMode: "single" | "separate";
                 options: {
@@ -1695,6 +1701,7 @@ export declare const preparePostPurchaseMemberView: (widgetId: number, settings:
                         amount: number;
                         type: "price" | "fixed_amount" | "percentage";
                     } | undefined;
+                    sts?: true | undefined;
                 } | undefined;
             };
             display: {
@@ -2004,6 +2011,7 @@ export declare const preparePostPurchaseMemberView: (widgetId: number, settings:
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {
@@ -2212,6 +2220,7 @@ export declare const preparePostPurchaseMemberView: (widgetId: number, settings:
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {
@@ -2300,6 +2309,7 @@ export declare const preparePostPurchaseMemberAdmissionView: (widgetId: number,
                         amount: number;
                         type: "price" | "fixed_amount" | "percentage";
                     } | undefined;
+                    sts?: true | undefined;
                 } | undefined;
             };
             display: {
@@ -2609,6 +2619,7 @@ export declare const preparePostPurchaseMemberAdmissionView: (widgetId: number,
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {
@@ -2817,6 +2828,7 @@ export declare const preparePostPurchaseMemberAdmissionView: (widgetId: number,
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {

package/dist/server/preparePostPurchaseQuantityAdmissionView.d.ts

@@ -95,6 +95,7 @@ sts?: PostPurchaseStsContext) => {
                         amount: number;
                         type: "price" | "fixed_amount" | "percentage";
                     } | undefined;
+                    sts?: true | undefined;
                 } | undefined;
             };
             display: {
@@ -404,6 +405,7 @@ sts?: PostPurchaseStsContext) => {
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {
@@ -612,6 +614,7 @@ sts?: PostPurchaseStsContext) => {
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {

package/dist/server/preparePostPurchaseQuantityView.d.ts

@@ -83,6 +83,7 @@ sts?: PostPurchaseStsContext) => {
                         amount: number;
                         type: "price" | "fixed_amount" | "percentage";
                     } | undefined;
+                    sts?: true | undefined;
                 } | undefined;
             };
             display: {
@@ -392,6 +393,7 @@ sts?: PostPurchaseStsContext) => {
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {
@@ -600,6 +602,7 @@ sts?: PostPurchaseStsContext) => {
             modes: ("one-time" | "subscription")[];
             selector: "radio" | "dropdown";
         } | undefined;
+        sts?: true | undefined;
         variantCatalog?: {
             displayMode: "single" | "separate";
             options: {

package/dist/server/preparePostPurchaseStsMember.d.ts

@@ -73,6 +73,7 @@ export declare const preparePostPurchaseStsMember: (widgetId: number, settings:
                             amount: number;
                             type: "price" | "fixed_amount" | "percentage";
                         } | undefined;
+                        sts?: true | undefined;
                     } | undefined;
                 };
                 display: {
@@ -382,6 +383,7 @@ export declare const preparePostPurchaseStsMember: (widgetId: number, settings:
                 modes: ("one-time" | "subscription")[];
                 selector: "radio" | "dropdown";
             } | undefined;
+            sts?: true | undefined;
             variantCatalog?: {
                 displayMode: "single" | "separate";
                 options: {
@@ -590,6 +592,7 @@ export declare const preparePostPurchaseStsMember: (widgetId: number, settings:
                 modes: ("one-time" | "subscription")[];
                 selector: "radio" | "dropdown";
             } | undefined;
+            sts?: true | undefined;
             variantCatalog?: {
                 displayMode: "single" | "separate";
                 options: {

package/dist/server/preparePostPurchaseSubscription.d.ts

@@ -138,6 +138,7 @@ export declare const preparePostPurchaseSubscription: (settings: unknown, respon
                 amount: number;
                 type: "price" | "fixed_amount" | "percentage";
             } | undefined;
+            sts?: true | undefined;
         } | undefined;
     };
 } | {

package/dist/transforms/index.cjs

@@ -4441,9 +4441,11 @@ var HAS_RECURRING_TOTAL = "hasRecurringTotal";
 var HAS_RECURRING_SHIPPING = "hasRecurringShipping";
 var small = { color: "subdued", fontSize: "small" };
 var FOOTNOTES = ["Doesn't include tax, duties, or any applicable discounts.", "Auto-renews, skip or cancel anytime"];
+var countsRecurringShipping = ({ productType, upgradeToSubscription }) => productType === "subscription" && upgradeToSubscription.allow;
 var recurringSummary = (settings) => {
   if (!sellsSubscription(settings)) return [];
   const { global } = settings.language;
+  const shipping = countsRecurringShipping(settings);
   return [
     {
       direction: "rows",
@@ -4454,18 +4456,20 @@ var recurringSummary = (settings) => {
           columns: ["fill", "auto", "auto"],
           label: merchantLabel(global.recurringSubtotal, "Recurring subtotal"),
           spacing: "extraTight",
-          token: "{{recurringTotal}}",
+          token: shipping ? "{{recurringTotal}}" : "{{recurringSubtotal}}",
           variable: HAS_RECURRING_TOTAL
         }),
-        earnedRow({
-          after: "(included)",
-          columns: ["auto", "auto", "auto"],
-          label: { en: `${merchantLabel(global.recurringShipping, "Recurring shipping").en}:` },
-          look: small,
-          spacing: "extraTight",
-          token: "{{recurringShipping}}",
-          variable: HAS_RECURRING_SHIPPING
-        }),
+        ...shipping ? [
+          earnedRow({
+            after: "(included)",
+            columns: ["auto", "auto", "auto"],
+            label: { en: `${merchantLabel(global.recurringShipping, "Recurring shipping").en}:` },
+            look: small,
+            spacing: "extraTight",
+            token: "{{recurringShipping}}",
+            variable: HAS_RECURRING_SHIPPING
+          })
+        ] : [],
         ...FOOTNOTES.map((text) => ({
           content: { en: styledCopy(text, small) },
           sectionType: "text",
@@ -4474,7 +4478,9 @@ var recurringSummary = (settings) => {
       ],
       sectionType: "layout",
       spacing: "tight",
-      variables: earnedVariables([HAS_RECURRING_TOTAL, HAS_RECURRING_SHIPPING])
+      variables: earnedVariables(
+        shipping ? [HAS_RECURRING_TOTAL, HAS_RECURRING_SHIPPING] : [HAS_RECURRING_TOTAL]
+      )
     }
   ];
 };

package/dist/transforms/index.mjs

@@ -4380,9 +4380,11 @@ var HAS_RECURRING_TOTAL = "hasRecurringTotal";
 var HAS_RECURRING_SHIPPING = "hasRecurringShipping";
 var small = { color: "subdued", fontSize: "small" };
 var FOOTNOTES = ["Doesn't include tax, duties, or any applicable discounts.", "Auto-renews, skip or cancel anytime"];
+var countsRecurringShipping = ({ productType, upgradeToSubscription }) => productType === "subscription" && upgradeToSubscription.allow;
 var recurringSummary = (settings) => {
   if (!sellsSubscription(settings)) return [];
   const { global } = settings.language;
+  const shipping = countsRecurringShipping(settings);
   return [
     {
       direction: "rows",
@@ -4393,18 +4395,20 @@ var recurringSummary = (settings) => {
           columns: ["fill", "auto", "auto"],
           label: merchantLabel(global.recurringSubtotal, "Recurring subtotal"),
           spacing: "extraTight",
-          token: "{{recurringTotal}}",
+          token: shipping ? "{{recurringTotal}}" : "{{recurringSubtotal}}",
           variable: HAS_RECURRING_TOTAL
         }),
-        earnedRow({
-          after: "(included)",
-          columns: ["auto", "auto", "auto"],
-          label: { en: `${merchantLabel(global.recurringShipping, "Recurring shipping").en}:` },
-          look: small,
-          spacing: "extraTight",
-          token: "{{recurringShipping}}",
-          variable: HAS_RECURRING_SHIPPING
-        }),
+        ...shipping ? [
+          earnedRow({
+            after: "(included)",
+            columns: ["auto", "auto", "auto"],
+            label: { en: `${merchantLabel(global.recurringShipping, "Recurring shipping").en}:` },
+            look: small,
+            spacing: "extraTight",
+            token: "{{recurringShipping}}",
+            variable: HAS_RECURRING_SHIPPING
+          })
+        ] : [],
         ...FOOTNOTES.map((text) => ({
           content: { en: styledCopy(text, small) },
           sectionType: "text",
@@ -4413,7 +4417,9 @@ var recurringSummary = (settings) => {
       ],
       sectionType: "layout",
       spacing: "tight",
-      variables: earnedVariables([HAS_RECURRING_TOTAL, HAS_RECURRING_SHIPPING])
+      variables: earnedVariables(
+        shipping ? [HAS_RECURRING_TOTAL, HAS_RECURRING_SHIPPING] : [HAS_RECURRING_TOTAL]
+      )
     }
   ];
 };

package/package.json

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