@rebuy/rebuy 2.34.0 → 2.35.0

package/dist/index.mjs

@@ -1269,6 +1269,7 @@ var borderWidths = ["base", "medium", "thick"];
 var BorderWidth = freezeEnum(borderWidths);
 var buttonActions = [
   "acceptOffer",
+  "addGift",
   "addToOrder",
   "declineAllOffers",
   "declineOffer",
@@ -1278,6 +1279,7 @@ var buttonActions = [
   "goToPrevPage",
   "goToURL",
   "removeFromOrder",
+  "removeGift",
   "selectVariant",
   "showPagination",
   "switchToSubscription",
@@ -1576,22 +1578,10 @@ import { z as z27 } from "zod";
 
 // src/schema/widgets/checkout-and-beyond/banner.ts
 import { z as z11 } from "zod";
-var CABBannerSection = z11.lazy(
-  () => CABLayoutSection.omit({ sectionType: true }).extend({
-    buttonField: z11.enum(buttonFields).optional(),
-    color: z11.enum(bannerColors).default("info"),
-    dismissible: z11.boolean().default(true),
-    sectionType: z11.literal(SectionType.banner).default(SectionType.banner)
-  })
-);
 
-// src/schema/widgets/checkout-and-beyond/button.ts
-import { v7 as uuidv73 } from "uuid";
-import { z as z14 } from "zod";
-
-// src/schema/widgets/checkout-and-beyond/image.ts
-import { v7 as uuidv7 } from "uuid";
-import { z as z12 } from "zod";
+// src/schema/widgets/checkout-and-beyond/utils.ts
+import { isPlainObject, mapValues } from "es-toolkit";
+import { every, get as get2, isArray, isString, map, size, toPairs } from "es-toolkit/compat";
 
 // src/schema/widgets/checkout-and-beyond/regex.ts
 var ARRAY_INDEX_STRING = /^(0|[1-9]\d*)$/;
@@ -1601,8 +1591,6 @@ var ROOT_RELATIVE_PATH_REGEX = /^\/(?!\/)/;
 var HTML_TAGS_REGEX = /<\/?[a-zA-Z][^>]*>/g;
 
 // src/schema/widgets/checkout-and-beyond/utils.ts
-import { isPlainObject, mapValues } from "es-toolkit";
-import { every, get as get2, isArray, isString, map, size, toPairs } from "es-toolkit/compat";
 var isHTML = (html = "") => {
   if (typeof window !== "undefined") {
     const parser = new DOMParser();
@@ -1644,13 +1632,158 @@ var convertNumericObjects = (input) => {
   return input;
 };
 
+// src/schema/widgets/checkout-and-beyond/banner.ts
+var CABBannerSection = z11.lazy(
+  () => CABLayoutSection.omit({ sectionType: true }).extend({
+    buttonField: z11.enum(buttonFields).optional(),
+    color: z11.enum(bannerColors).default("info"),
+    dismissible: z11.boolean().default(true),
+    /**
+     * The `s-banner` heading — localized content (a buyer can see a merchant-composed banner). Absent OR
+     * blank ⇒ no heading; the renderer emits no heading slot for `''` rather than an empty one.
+     *
+     * Merchant-composed buyer-facing plain text, so it rejects HTML at the boundary the same way
+     * `CABImageSection.altText` and `CABTextSection.content` do (the unchecked localized records elsewhere —
+     * `progressBar`'s gift labels, `reviews`' plurals — are converter/constant-sourced, not merchant input).
+     *
+     * The refinement is a last-resort ASSERTION, not the normalization boundary: `normalizeTextContent` only
+     * rewrites `sectionType: 'text'` nodes' `content`, so nothing strips markup or canonicalizes `{token}`
+     * here. A producer must strip upstream the way `composeOffer` does for `altText`. Get it wrong and
+     * `salvageSections` stubs the whole banner (children included) with a drift report — degraded, reported,
+     * not a 500. Nothing emits `heading` yet; the first converter that maps merchant banner copy into it
+     * either strips first or teaches `normalizeTextContent` to strip this field.
+     */
+    heading: z11.record(z11.string(), z11.string().refine(checkForHTML, NO_HTML)).optional(),
+    sectionType: z11.literal(SectionType.banner).default(SectionType.banner)
+  })
+);
+
+// src/schema/widgets/checkout-and-beyond/button.ts
+import { v7 as uuidv73 } from "uuid";
+import { z as z14 } from "zod";
+
+// src/schema/widgets/checkout-and-beyond/image.ts
+import { v7 as uuidv7 } from "uuid";
+import { z as z12 } from "zod";
+
+// src/schema/widgets/checkout-and-beyond/icons.ts
+var iconNames = [
+  "alert-circle",
+  "alert-triangle",
+  "alert-triangle-filled",
+  "arrow-down",
+  "arrow-left",
+  "arrow-right",
+  "arrow-up",
+  "arrow-up-right",
+  "bag",
+  "bullet",
+  "calendar",
+  "camera",
+  "caret-down",
+  "cart",
+  "cash-dollar",
+  "categories",
+  "check",
+  "check-circle",
+  "check-circle-filled",
+  "chevron-down",
+  "chevron-left",
+  "chevron-right",
+  "chevron-up",
+  "circle",
+  "clipboard",
+  "clock",
+  "credit-card",
+  "delete",
+  "delivered",
+  "delivery",
+  "disabled",
+  "discount",
+  "edit",
+  "email",
+  "empty",
+  "external",
+  "filter",
+  "geolocation",
+  "gift-card",
+  "globe",
+  "grid",
+  "image",
+  "info",
+  "info-filled",
+  "list-bulleted",
+  "location",
+  "lock",
+  "map",
+  "menu",
+  "menu-horizontal",
+  "menu-vertical",
+  "minus",
+  "mobile",
+  "note",
+  "order",
+  "organization",
+  "plus",
+  "profile",
+  "question-circle",
+  "question-circle-filled",
+  "reorder",
+  "reset",
+  "return",
+  "savings",
+  "search",
+  "settings",
+  "star",
+  "star-filled",
+  "star-half",
+  "store",
+  "truck",
+  "upload",
+  "x",
+  "x-circle",
+  "x-circle-filled"
+];
+var IconName = freezeEnum(iconNames);
+var iconSizes = ["base", "large", "large-100", "small", "small-100", "small-200"];
+var IconSize = freezeEnum(iconSizes);
+var iconTones = ["auto", "critical", "custom", "info", "neutral", "success", "warning"];
+var IconTone = freezeEnum(iconTones);
+
 // src/schema/widgets/checkout-and-beyond/image.ts
-var CABImageSection = z12.object({
+var CABImageSectionFields = z12.object({
   altText: z12.string().refine(checkForHTML, NO_HTML).default(""),
-  aspectRatio: z12.literal(1).nullable().default(null),
+  /**
+   * Image width÷height (e.g. `46` for the progress-bar fill); `null` renders at natural size. Any POSITIVE
+   * ratio — never limited to 1, but never `0`/negative either: a renderer dividing by it would get `Infinity`,
+   * and CSS `aspect-ratio` drops a negative value and silently reverts to natural size.
+   */
+  aspectRatio: z12.number().positive().nullable().default(null),
   border: z12.lazy(() => CABBorder),
   buttonField: z12.enum(buttonFields).optional(),
-  category: z12.enum(["gallery", "icons", "payment-methods", "secure-checkout"]).nullable().default(null),
+  /**
+   * `icon` renders `source` as a single `s-icon` by name (the uber-image path covers icons too), reading
+   * `iconSize`/`iconTone`. The other values are a harmless informational holdover from the previous
+   * implementation — they were never significant to rendering (`icons`, plural, is NOT deprecated, just one of
+   * those inert legacy tags); `icon` is the first value that means anything.
+   *
+   * INVARIANT, encoded by the `.superRefine` below (a refined object IS a valid `z.discriminatedUnion` member
+   * in zod 4 — see `CABTextSection`): `category: 'icon'` ⇒ `source` is an icon name or `''` (icon not yet
+   * chosen); any other category ⇒ `source` is NOT a bare icon name, so it stays a URL/token/`''`.
+   *
+   * Encoded rather than left to the renderer because `source` is ONE union with no category gate, so widening
+   * it with `iconNames` also widened what a STORED payload may contain: 14 of the names are plain English
+   * words (`image`, `x`, `search`, `note`, `order`, `globe`, …), and a legacy `source: 'image'` used to fail
+   * parse — which `salvageSections` turns into a null-rendering stub PLUS a drift report. Ungated it would
+   * instead parse and reach the renderer as `<img src="image">`: a broken image, silently, where the old
+   * behavior degraded gracefully and told us about it. The client-assembled half of the invariant was never
+   * the risky half.
+   */
+  category: z12.enum(["gallery", "icon", "icons", "payment-methods", "secure-checkout"]).nullable().default(null),
+  /** `icon`-mode only: the `s-icon` `size`; `null` ⇒ the component default (`base`). Ignored by image treatments. */
+  iconSize: z12.enum(iconSizes).nullable().default(null),
+  /** `icon`-mode only: the `s-icon` `tone`; `null` ⇒ the component default (`auto`). Ignored by image treatments. */
+  iconTone: z12.enum(iconTones).nullable().default(null),
   name: z12.string().optional(),
   naturalHeight: z12.number().default(0),
   naturalWidth: z12.number().default(0),
@@ -1662,9 +1795,31 @@ var CABImageSection = z12.object({
   rule: CABRule.optional(),
   sectionId: z12.uuid().default(() => uuidv7()),
   sectionType: z12.literal(SectionType.image).default(SectionType.image),
-  source: z12.union([z12.url(), z12.literal(""), z12.string().regex(DYNAMIC_TOKEN_REGEX)]).default(""),
+  /**
+   * An image URL or dynamic token, an empty default, or — when `category: 'icon'` — an icon NAME. Icon mode
+   * takes a name or `''` only, NOT a token: no renderer resolves a token to an icon today, so accepting one
+   * would promise a capability that doesn't exist. Widen the refine's carve-out to `DYNAMIC_TOKEN_REGEX` when a
+   * server-chosen tier icon actually needs it.
+   */
+  source: z12.union([z12.url(), z12.literal(""), z12.string().regex(DYNAMIC_TOKEN_REGEX), z12.enum(iconNames)]).default(""),
   width: z12.number().default(100)
 });
+var iconNameSet = new Set(iconNames);
+var isIconName = (source) => iconNameSet.has(source);
+var CABImageSection = CABImageSectionFields.superRefine(({ category, source }, ctx) => {
+  if (category === "icon" && source !== "" && !isIconName(source))
+    ctx.addIssue({
+      code: "custom",
+      message: "icon-mode source must be an icon name",
+      path: ["source"]
+    });
+  if (category !== "icon" && isIconName(source))
+    ctx.addIssue({
+      code: "custom",
+      message: "source must be a URL or dynamic token unless category is `icon`",
+      path: ["source"]
+    });
+});
 
 // src/schema/widgets/checkout-and-beyond/text.ts
 import { forEach, isString as isString2 } from "es-toolkit/compat";
@@ -1784,6 +1939,21 @@ var CABButtonSection = z14.object({
   sectionId: z14.uuid().default(() => uuidv73()),
   sections: z14.union([z14.array(CABButtonContent), z14.strictObject({}).transform(() => [])]).default(() => []),
   sectionType: z14.literal(SectionType.button).default(SectionType.button),
+  /**
+   * The smart-cart tier this button acts on (`addGift`/`removeGift`): scopes the click to one tier's gift. The
+   * client resolves the tier's gift (productId) from the progress-bar context by this `tierId` — the button node
+   * stays data, no bespoke per-tier wiring. Absent on non-gift buttons (offer add/remove, navigation, links).
+   *
+   * Deliberately NOT `CABTextTier` (the shape `CABTextSection.tier` uses): a gift button acts on a tier the bar
+   * already resolved, so it needs the id and nothing else. Reusing the text tier would make `threshold`
+   * required, leave `tierId` optional, and DEFAULT `tierType` to `'shipping'` — a schema-supplied wrong answer
+   * on a gift button. Unknown keys are stripped, so a client spreading a whole tier in still parses.
+   *
+   * `.min(1)` because an empty id IS the silently-id-less state this shape exists to prevent: the client's
+   * lookup finds no tier and the click resolves to nothing. Safe to bound — the field is new, so there are no
+   * stored payloads to grandfather, and the producer is client code, not a merchant form.
+   */
+  tier: z14.object({ tierId: z14.string().min(1) }).optional(),
   /** Fire-and-forget pixel POSTed when the button is clicked (e.g. a Monetize decline). */
   trackingUrl: z14.string().optional()
 });
@@ -2079,8 +2249,12 @@ var CABProgressTier = z23.object({
   }).optional(),
   /**
    * The step-row label at this tier's slot (onsite `getTierLabel`): the merchant custom label, else the
-   * type default ('Free Shipping' / product title / '{n}% Discount'). Localized content; blank ⇒ no
-   * label under the tier's icon. Plain text — the step row is a compact icon+label, not rich copy.
+   * type default — 'Free Shipping' or '{n}% Discount'. A PRODUCT tier gets NO converter label: its name is
+   * the gift PRODUCT title, which the converter can't supply (config carries only product IDs), so the
+   * client resolves it (authoritative Shopify title, React parity) with its own localized generic fallback.
+   * Localized content; absent OR blank ⇒ no label under the tier's icon (the converter's `toTierMeta` already
+   * turns a blank label into an absent key, and a client-authored blank means the same thing — the renderer
+   * emits no caption slot rather than an empty one). Plain text — a compact icon+label.
    */
   label: z23.record(z23.string(), z23.string()).optional(),
   /**
@@ -4164,6 +4338,7 @@ export {
   CABDiscountSection,
   CABExperiment,
   CABImageSection,
+  CABImageSectionFields,
   CABIntegrations,
   CABLayoutSection,
   CABMonetizeSection,
@@ -4205,6 +4380,9 @@ export {
   HEX_COLOR_REGEX,
   HTML_TAGS_REGEX,
   HorizontalAlignment,
+  IconName,
+  IconSize,
+  IconTone,
   Identity,
   ImageBlock,
   ImageContentBlock,
@@ -4299,6 +4477,9 @@ export {
   getIdFromGraphUrl,
   hasHTMLInDoc,
   horizontalAlignments,
+  iconNames,
+  iconSizes,
+  iconTones,
   isBannerType,
   isBase64Encoded,
   isButtonType,