@rebuy/rebuy 2.34.0 → 2.35.0

package/dist/transforms/index.mjs

@@ -14,6 +14,7 @@ var borderWidths = ["base", "medium", "thick"];
 var BorderWidth = freezeEnum(borderWidths);
 var buttonActions = [
   "acceptOffer",
+  "addGift",
   "addToOrder",
   "declineAllOffers",
   "declineOffer",
@@ -23,6 +24,7 @@ var buttonActions = [
   "goToPrevPage",
   "goToURL",
   "removeFromOrder",
+  "removeGift",
   "selectVariant",
   "showPagination",
   "switchToSubscription",
@@ -152,6 +154,90 @@ var VariantSelector = freezeEnum(variantSelectors);
 var verticalAlignments = ["top", "middle", "bottom"];
 var VerticalAlignment = freezeEnum(verticalAlignments);
 
+// 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/regex.ts
 var DYNAMIC_TOKEN_REGEX = /^\{\{\s*[A-Za-z]+\s*\}\}$/;
 var HEX_COLOR_REGEX = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
@@ -262,12 +348,44 @@ var CABLayoutSection = z2.object({
   width: z2.number().default(100)
 });
 
+// src/schema/widgets/checkout-and-beyond/utils.ts
+import { isPlainObject, mapValues } from "es-toolkit";
+import { every, get, isArray, isString, map, size, toPairs } from "es-toolkit/compat";
+var isHTML = (html = "") => {
+  if (typeof window !== "undefined") {
+    const parser = new DOMParser();
+    const doc = parser.parseFromString(html, "text/html");
+    const hasHTML = (nodeList) => Array.from(nodeList).some((node) => node.nodeType === 1);
+    return hasHTML(doc.body.childNodes) || hasHTML(doc.head.childNodes);
+  }
+  return html.search(HTML_TAGS_REGEX) !== -1;
+};
+var hasHTMLInDoc = (doc) => doc.content.some(({ content = [] }) => content.some(({ text }) => isHTML(text)));
+var checkForHTML = (input) => !(isString(input) && isHTML(input) || isPlainObject(input) && hasHTMLInDoc(input));
+var NO_HTML = { message: "HTML is not supported" };
+
 // src/schema/widgets/checkout-and-beyond/banner.ts
 var CABBannerSection = z3.lazy(
   () => CABLayoutSection.omit({ sectionType: true }).extend({
     buttonField: z3.enum(buttonFields).optional(),
     color: z3.enum(bannerColors).default("info"),
     dismissible: z3.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: z3.record(z3.string(), z3.string().refine(checkForHTML, NO_HTML)).optional(),
     sectionType: z3.literal(SectionType.banner).default(SectionType.banner)
   })
 );
@@ -280,24 +398,6 @@ import { z as z5 } from "zod";
 import { forEach, isString as isString2 } from "es-toolkit/compat";
 import { v7 as uuidv72 } from "uuid";
 import { z as z4 } from "zod";
-
-// src/schema/widgets/checkout-and-beyond/utils.ts
-import { isPlainObject, mapValues } from "es-toolkit";
-import { every, get, isArray, isString, map, size, toPairs } from "es-toolkit/compat";
-var isHTML = (html = "") => {
-  if (typeof window !== "undefined") {
-    const parser = new DOMParser();
-    const doc = parser.parseFromString(html, "text/html");
-    const hasHTML = (nodeList) => Array.from(nodeList).some((node) => node.nodeType === 1);
-    return hasHTML(doc.body.childNodes) || hasHTML(doc.head.childNodes);
-  }
-  return html.search(HTML_TAGS_REGEX) !== -1;
-};
-var hasHTMLInDoc = (doc) => doc.content.some(({ content = [] }) => content.some(({ text }) => isHTML(text)));
-var checkForHTML = (input) => !(isString(input) && isHTML(input) || isPlainObject(input) && hasHTMLInDoc(input));
-var NO_HTML = { message: "HTML is not supported" };
-
-// src/schema/widgets/checkout-and-beyond/text.ts
 var enumOrOmit = (...vals) => z4.string().transform((val) => vals.includes(val) ? val : void 0).optional();
 var TiptapText = z4.object({
   marks: z4.union([
@@ -412,6 +512,21 @@ var CABButtonSection = z5.object({
   sectionId: z5.uuid().default(() => uuidv73()),
   sections: z5.union([z5.array(CABButtonContent), z5.strictObject({}).transform(() => [])]).default(() => []),
   sectionType: z5.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: z5.object({ tierId: z5.string().min(1) }).optional(),
   /** Fire-and-forget pixel POSTed when the button is clicked (e.g. a Monetize decline). */
   trackingUrl: z5.string().optional()
 });
@@ -785,8 +900,12 @@ var CABProgressTier = z14.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: z14.record(z14.string(), z14.string()).optional(),
   /**
@@ -1047,12 +1166,39 @@ var CABSection = z18.lazy(
 );
 
 // src/schema/widgets/checkout-and-beyond/image.ts
-var CABImageSection = z19.object({
+var CABImageSectionFields = z19.object({
   altText: z19.string().refine(checkForHTML, NO_HTML).default(""),
-  aspectRatio: z19.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: z19.number().positive().nullable().default(null),
   border: z19.lazy(() => CABBorder),
   buttonField: z19.enum(buttonFields).optional(),
-  category: z19.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: z19.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: z19.enum(iconSizes).nullable().default(null),
+  /** `icon`-mode only: the `s-icon` `tone`; `null` ⇒ the component default (`auto`). Ignored by image treatments. */
+  iconTone: z19.enum(iconTones).nullable().default(null),
   name: z19.string().optional(),
   naturalHeight: z19.number().default(0),
   naturalWidth: z19.number().default(0),
@@ -1064,9 +1210,31 @@ var CABImageSection = z19.object({
   rule: CABRule.optional(),
   sectionId: z19.uuid().default(() => uuidv712()),
   sectionType: z19.literal(SectionType.image).default(SectionType.image),
-  source: z19.union([z19.url(), z19.literal(""), z19.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: z19.union([z19.url(), z19.literal(""), z19.string().regex(DYNAMIC_TOKEN_REGEX), z19.enum(iconNames)]).default(""),
   width: z19.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/transforms/contentBlockV1/stripContentBlockHtml.ts
 var HTML_COMMENT_RE = /<!--[\s\S]*?-->/g;
@@ -2979,7 +3147,7 @@ var tierLabel = (tier) => {
   if (type === "shipping") return "Free Shipping";
   if (type === "discount")
     return tier.discountType === "fixedAmount" ? "{{discountAmount}} Off" : `${tier.discountAmountFromTotal ?? 0}% Discount`;
-  return tier.products?.[0]?.title ?? tier.allProducts?.[0]?.title ?? "Free Product";
+  return void 0;
 };
 var discountOf = (tier) => {
   if (tier.type !== "discount") return void 0;