@rebuy/rebuy 3.28.0 → 3.29.0

package/dist/transforms/index.mjs

@@ -1347,7 +1347,14 @@ var CABReviewsSection = z17.object({
   sectionId: z17.uuid().default(() => uuidv710()),
   sectionType: z17.literal(SectionType.reviews).default(SectionType.reviews),
   size: z17.enum(reviewsSizes).default(ReviewsSize.default),
-  strokeColor: z17.string().default("#fadb14"),
+  /**
+   * Star outline color, interpolated into a style by the renderer, so it is hex-constrained like
+   * `CABButtonSection.color`. The legacy source (`PostPurchaseSettings.styles.starStrokeColor`) is a free
+   * string: its converter must validate and fall back to this default rather than let one odd value drop
+   * the whole reviews section.
+   */
+  strokeColor: z17.string().regex(HEX_COLOR_REGEX).default("#fadb14"),
+  /** Star outline width in px; `0` draws no outline. The legacy `styles.strokeWidth` is a STRING ('1') — its converter coerces. */
   strokeWidth: z17.number().nonnegative().default(0)
 });
 
@@ -3527,7 +3534,7 @@ var convertOfferToV2 = ({ id, name, settings }) => {
 var parseShielded = (schema, raw, transform = (input) => input) => schema.parse(transform(convertNumericObjects(deepCamelCase(raw))));
 
 // src/transforms/postPurchase/convertMessagePreview.ts
-import { z as z27 } from "zod";
+import { z as z30 } from "zod";
 
 // src/server/shared.ts
 var NotFoundError = class extends Error {
@@ -3758,6 +3765,150 @@ var convertCalloutBlock = (raw, report) => {
   return sections.length ? [CABLayoutSection.parse({ alignment: { horizontal }, frame: "callout", sections })] : [];
 };
 
+// src/transforms/postPurchase/convertImageFrame.ts
+import { z as z26 } from "zod";
+
+// src/transforms/postPurchase/sizeImageSource.ts
+var sizeImageSource = (source, size) => {
+  const extension = source.split(".").pop();
+  for (const previous of ["small", "medium", "large", "original", "master"]) {
+    source = source.replace(`_${previous}.${extension}`, `.${extension}`);
+  }
+  return source.replace(`.${extension}`, `${size === void 0 ? "" : `_${size}`}.${extension}`);
+};
+
+// src/transforms/postPurchase/convertImageFrame.ts
+var Source = z26.url().default("https://cdn.shopify.com/s/files/1/0605/0555/5177/files/placeholder.jpg?v=1657762972");
+var DEFAULT_IMAGE_SIZE = 20;
+var convertImageFrame = (raw) => {
+  const parsed = ImageBlock.shape.settings.options[0].safeParse(raw);
+  if (!parsed.success) return null;
+  const settings = parsed.data;
+  const source = sizeImageSource(Source.parse(settings.image || void 0));
+  const withAlt = CABImageSection.safeParse({ altText: settings.alt, source });
+  const image = withAlt.success ? withAlt.data : CABImageSection.parse({ source });
+  const size = settings.imageSize > 0 ? settings.imageSize : DEFAULT_IMAGE_SIZE;
+  return CABLayoutSection.parse({
+    alignment: { horizontal: "center" },
+    direction: "grid",
+    grid: { columns: size <= 1 ? ["100%"] : [size] },
+    sections: [image],
+    width: size <= 1 ? size * 100 : 100
+  });
+};
+
+// src/transforms/postPurchase/convertImageBlock.ts
+var dropMalformedAlt = (raw) => {
+  if (typeof raw !== "object" || raw === null) return raw;
+  const { settings, ...rest } = raw;
+  if (typeof settings !== "object" || settings === null || Array.isArray(settings)) return raw;
+  const { alt, ...restSettings } = settings;
+  if (typeof alt === "string" || alt === void 0) return raw;
+  return { ...rest, settings: restSettings };
+};
+var convertImageBlock = (raw, report) => {
+  const block = ImageBlock.safeParse(dropMalformedAlt(raw));
+  const image = block.success ? convertImageFrame(block.data.settings) : null;
+  if (!image) {
+    report?.({ detail: "Unreadable post-purchase image", kind: "section" });
+    return [];
+  }
+  return [
+    CABLayoutSection.parse({
+      alignment: { horizontal: "center" },
+      frame: "offer-content",
+      sections: [image],
+      spacing: "none"
+    })
+  ];
+};
+
+// src/transforms/postPurchase/convertImageContentBlock.ts
+import { z as z28 } from "zod";
+
+// src/transforms/postPurchase/convertImageContentText.ts
+var fields2 = ["superTitle", "title", "description"];
+var convertImageContentText = (settings, report) => {
+  const horizontal = { center: "center", leading: "start", trailing: "end" }[settings.horizontalAlignment];
+  const sections = fields2.flatMap((field) => {
+    const omit = () => {
+      report?.({ detail: `Unreadable post-purchase image-content field: ${field}`, kind: "section" });
+      return [];
+    };
+    const value = ImageContentBlock.shape.settings.shape[field].safeParse(settings[field]);
+    if (!value.success) return omit();
+    const text = value.data;
+    if (text === null || text === "") return [];
+    const content = typeof text === "string" ? {
+      content: [
+        {
+          attrs: { textAlign: horizontal },
+          content: [styledTextRun(text, field !== "description", settings[`${field}Size`])]
+        }
+      ]
+    } : text;
+    const section = CABTextSection.safeParse({ content: { en: content } });
+    return section.success ? [section.data] : omit();
+  });
+  return CABLayoutSection.parse({ alignment: { horizontal }, sections });
+};
+
+// src/transforms/postPurchase/imageContentSettings.ts
+import { z as z27 } from "zod";
+var ImageContentSettings = ImageContentBlock.shape.settings.pick({
+  descriptionSize: true,
+  horizontalAlignment: true,
+  superTitleSize: true,
+  swapContent: true,
+  titleSize: true
+}).extend({
+  alt: z27.unknown().optional(),
+  description: z27.unknown().optional(),
+  image: z27.unknown().optional(),
+  imagePlacement: ImageContentBlock.shape.settings.shape.imagePlacement.unwrap().nullable(),
+  imageSize: ImageContentBlock.shape.settings.shape.imageSize.pipe(z27.number().positive()),
+  superTitle: z27.unknown().optional(),
+  title: z27.unknown().optional()
+});
+
+// src/transforms/postPurchase/convertImageContentBlock.ts
+var Shell2 = z28.object({ settings: ImageContentSettings, type: z28.literal("image_content") });
+var PROPORTIONAL_BREAK_AT = 500;
+var convertImageContentBlock = (raw, report) => {
+  const shell = Shell2.safeParse(raw);
+  if (!shell.success) {
+    report?.({ detail: "Unreadable post-purchase image-content block", kind: "section" });
+    return [];
+  }
+  const settings = shell.data.settings;
+  const alt = typeof settings.alt === "string" ? settings.alt : void 0;
+  if (settings.alt !== void 0 && alt === void 0) {
+    report?.({ detail: "Unreadable post-purchase image-content alt text", kind: "section" });
+  }
+  const image = convertImageFrame({ alt, image: settings.image, imageSize: settings.imageSize });
+  if (!image) report?.({ detail: "Unreadable post-purchase image-content image", kind: "section" });
+  const text = convertImageContentText(settings, report);
+  const textFrame = CABLayoutSection.parse({ direction: "grid", grid: { columns: ["100%"] }, sections: [text] });
+  const placement = settings.imagePlacement ?? (settings.swapContent ? "right" : "left");
+  const imageFirst = placement === "left" || placement === "top";
+  const sections = imageFirst ? [image, textFrame] : [textFrame, image];
+  const ordered = sections.filter((section) => section !== null);
+  const inner = placement === "left" || placement === "right" ? CABLayoutSection.parse({
+    sections: ordered,
+    spacing: "loose",
+    wrapping: {
+      breakAt: settings.imageSize <= 1 ? PROPORTIONAL_BREAK_AT : settings.imageSize,
+      maxPerLine: 2
+    }
+  }) : CABLayoutSection.parse({
+    direction: "grid",
+    grid: { columns: ["100%"] },
+    sections: [CABLayoutSection.parse({ sections: ordered })],
+    width: 95
+  });
+  return [CABLayoutSection.parse({ frame: "offer-content", sections: [inner], spacing: "none" })];
+};
+
 // src/transforms/postPurchase/convertPayButtonBlock.ts
 var convertPayButtonBlock = (raw, report) => {
   const omit = () => {
@@ -3786,6 +3937,60 @@ var convertPayButtonBlock = (raw, report) => {
   ];
 };
 
+// src/transforms/postPurchase/convertProductInformation.ts
+var convertProductInformation = (raw, report) => {
+  const block = ProductInformationBlock.safeParse(raw);
+  if (!block.success) {
+    report?.({ detail: "Unreadable post-purchase product information", kind: "section" });
+    return [];
+  }
+  return [
+    CABOffersSection.parse({
+      direction: "grid",
+      sections: [
+        CABLayoutSection.parse({
+          alignment: { horizontal: "center" },
+          sections: [
+            CABLayoutSection.parse({
+              alignment: { horizontal: "center" },
+              direction: "grid",
+              grid: { columns: [250] },
+              sections: [
+                CABImageSection.parse({ altText: "{{productTitle}}", source: "{{productImage}}" })
+              ],
+              width: 90
+            })
+          ]
+        }),
+        CABLayoutSection.parse({
+          sections: [
+            CABTextSection.parse({
+              content: {
+                en: {
+                  content: [
+                    {
+                      content: [
+                        {
+                          marks: [{ attrs: { fontSize: "heading" }, type: "textStyle" }],
+                          text: "{{productTitle}}"
+                        }
+                      ]
+                    }
+                  ]
+                }
+              }
+            }),
+            CABReviewsSection.parse({}),
+            CABTextSection.parse({ content: { en: "{{productDescription}}" } })
+          ]
+        })
+      ],
+      spacing: "extraLoose",
+      wrapping: { breakAt: 500, maxPerLine: block.data.hideProductImage ? 1 : 2 }
+    })
+  ];
+};
+
 // src/transforms/postPurchase/convertSeparatorBlock.ts
 var convertSeparatorBlock = (raw, report) => {
   if (!SeparatorBlock.safeParse(raw).success) {
@@ -3796,34 +4001,36 @@ var convertSeparatorBlock = (raw, report) => {
 };
 
 // src/transforms/postPurchase/convertTextBlock.ts
-import { z as z26 } from "zod";
-var fields2 = ["superTitle", "title", "description"];
+import { z as z29 } from "zod";
+var fields3 = ["superTitle", "title", "description"];
 var styles = {
   description: [{ attrs: { color: "base", fontSize: "small" }, type: "textStyle" }],
   superTitle: [{ attrs: { color: "subdued", fontSize: "small" }, type: "textStyle" }],
   title: [{ type: "bold" }, { attrs: { color: "base", fontSize: "large" }, type: "textStyle" }]
 };
 var settingsSchema = TextBlock.shape.settings;
-var Shell2 = z26.object({
+var Shell3 = z29.object({
   settings: settingsSchema.pick({ horizontalAlignment: true }).extend({
-    description: z26.unknown().optional(),
-    superTitle: z26.unknown().optional(),
-    title: z26.unknown().optional()
+    description: z29.unknown().optional(),
+    superTitle: z29.unknown().optional(),
+    title: z29.unknown().optional()
   }),
-  type: z26.literal("text")
+  type: z29.literal("text")
 });
 var convertTextBlock = (raw, report) => {
-  const shell = Shell2.safeParse(raw);
+  const shell = Shell3.safeParse(raw);
   if (!shell.success) {
     report?.({ detail: "Unreadable post-purchase text block", kind: "section" });
     return [];
   }
-  const values = fields2.map((field) => ({
+  const values = fields3.map((field) => ({
     field,
     result: settingsSchema.shape[field].safeParse(shell.data.settings[field])
   }));
   const horizontal = { center: "center", leading: "start", trailing: "end" }[shell.data.settings.horizontalAlignment];
-  const styled = values.every(({ result }) => result.success && typeof result.data === "string");
+  const styled = values.every(
+    ({ result }) => result.success && (result.data === null || typeof result.data === "string")
+  );
   const omit = (field) => {
     report?.({ detail: `Unreadable post-purchase text field: ${field}`, kind: "section" });
     return [];
@@ -3836,20 +4043,18 @@ var convertTextBlock = (raw, report) => {
     const section = CABTextSection.safeParse({ content: { en: content } });
     return section.success ? [section.data] : omit(field);
   });
-  return [
-    CABLayoutSection.parse({
-      alignment: {
-        horizontal
-      },
-      sections
-    })
-  ];
+  return sections.length ? [CABLayoutSection.parse({ alignment: { horizontal }, sections })] : [];
 };
 
 // src/transforms/postPurchase/convertTimerBlock.ts
 var Presentation = TimerBlock.pick({ styles: true }).extend({
   settings: TimerBlock.shape.settings.pick({ title: true })
 });
+var withCountdown = (doc, run, textAlign) => {
+  const paragraphs = doc.content.length ? doc.content : [TiptapParagraph.parse({ attrs: { textAlign } })];
+  const last = paragraphs[paragraphs.length - 1];
+  return { ...doc, content: [...paragraphs.slice(0, -1), { ...last, content: [...last.content, run] }] };
+};
 var convertTimerBlock = (raw, report) => {
   const omit = () => {
     report?.({ detail: "Unreadable post-purchase timer display", kind: "section" });
@@ -3860,17 +4065,15 @@ var convertTimerBlock = (raw, report) => {
   const { title } = parsed.data.settings;
   const styles2 = parsed.data.styles;
   const horizontal = { center: "center", leading: "start", trailing: "end" }[styles2.textAlignment];
+  const countdown = styledTextRun(" {{timeRemaining}}", styles2.timerEmphasized, styles2.timerSize);
   const content = typeof title === "string" ? {
     content: [
       {
         attrs: { textAlign: horizontal },
-        content: [
-          styledTextRun(title, styles2.titleEmphasized, styles2.titleSize),
-          styledTextRun(" {{timeRemaining}}", styles2.timerEmphasized, styles2.timerSize)
-        ]
+        content: [styledTextRun(title, styles2.titleEmphasized, styles2.titleSize), countdown]
       }
     ]
-  } : title;
+  } : withCountdown(title, countdown, horizontal);
   const text = CABTextSection.safeParse({ content: { en: content } });
   if (!text.success) return omit();
   return [
@@ -3884,14 +4087,17 @@ var convertTimerBlock = (raw, report) => {
 };
 
 // src/transforms/postPurchase/convertMessagePreview.ts
-var MessageWidget = z27.object({
-  blocks: z27.array(z27.unknown()).min(1),
-  type: z27.literal("shopify_post_purchase_extension")
+var MessageWidget = z30.object({
+  blocks: z30.array(z30.unknown()).min(1),
+  type: z30.literal(WidgetType.shopify_post_purchase_extension)
 });
-var BlockType2 = z27.object({ type: z27.string() });
+var BlockType2 = z30.object({ type: z30.string() });
 var converters = {
   callout_banner: convertCalloutBlock,
+  image: convertImageBlock,
+  image_content: convertImageContentBlock,
   pay_button: convertPayButtonBlock,
+  product_information: convertProductInformation,
   separator: convertSeparatorBlock,
   text: convertTextBlock,
   timer: convertTimerBlock
@@ -3905,7 +4111,7 @@ var convertMessagePreview = (id, settings, report) => {
     sections: parsed.data.blocks.flatMap((block) => {
       const type = BlockType2.safeParse(block);
       const kind = type.success ? type.data.type : void 0;
-      const convert2 = kind ? converters[kind] : void 0;
+      const convert2 = kind && Object.hasOwn(converters, kind) ? converters[kind] : void 0;
       if (convert2) return convert2(block, report);
       report?.({
         detail: kind ? `Unsupported post-purchase block type: ${kind}` : "Unreadable post-purchase block: missing type",

package/dist/transforms/postPurchase/convertImageBlock.d.ts

@@ -0,0 +1,4 @@
+import { CABLayoutSection } from '../../schema/widgets/checkout-and-beyond/layout';
+import { type Reporter } from '../../server/shared';
+/** A standalone image block, framed as the post-purchase offer's own content card. */
+export declare const convertImageBlock: (raw: unknown, report?: Reporter) => CABLayoutSection[];

package/dist/transforms/postPurchase/convertImageContentBlock.d.ts

@@ -0,0 +1,7 @@
+import { CABLayoutSection } from '../../schema/widgets/checkout-and-beyond/layout';
+import { type Reporter } from '../../server/shared';
+/**
+ * Image with text, placed left/right/top/bottom of it. Alt text is read from THIS block's own settings
+ * only — the plain `image` block's `alt` is never rendered by legacy (plan decision 15).
+ */
+export declare const convertImageContentBlock: (raw: unknown, report?: Reporter) => CABLayoutSection[];

package/dist/transforms/postPurchase/convertImageContentText.d.ts

@@ -0,0 +1,5 @@
+import { CABLayoutSection } from '../../schema/widgets/checkout-and-beyond/layout';
+import { type Reporter } from '../../server/shared';
+import { type ImageContentSettings } from '../../transforms/postPurchase/imageContentSettings';
+/** Style readable strings independently; documents retain their authored marks and alignment. */
+export declare const convertImageContentText: (settings: ImageContentSettings, report?: Reporter) => CABLayoutSection;

package/dist/transforms/postPurchase/convertImageFrame.d.ts

@@ -0,0 +1,9 @@
+import { CABLayoutSection } from '../../schema/widgets/checkout-and-beyond/layout';
+/**
+ * Shared legacy image policy, preserving numeric pixel and proportional frame units. A malformed `alt`
+ * (e.g. stray HTML) never drops the image itself — legacy never rejected the whole block for it, so this
+ * retries without alt text rather than returning `null`. A non-positive `imageSize` (corrupted saved data;
+ * the schema only defaults on a missing value, not on `0` or a negative one) falls back to the schema's own
+ * default instead of producing a zero/negative-width column.
+ */
+export declare const convertImageFrame: (raw: unknown) => CABLayoutSection | null;

package/dist/transforms/postPurchase/convertMessagePreview.d.ts

@@ -1,8 +1,8 @@
 import { CABRootSection } from '../../schema/widgets/checkout-and-beyond/root';
 import { type Reporter } from '../../server/shared';
 /**
- * Converts a saved post-purchase widget's blocks into a CAB preview tree. Only the five converters this
- * slice ships handle their block; every other block type — future (image/image_content/product_information)
- * or truly unknown — reports and drops only itself, and an unreadable block (no `type`) does the same.
+ * Converts a saved post-purchase widget's blocks into a CAB preview tree. Only the eight converters above
+ * handle their block; a truly unknown block type reports and drops only itself, and an unreadable block
+ * (no `type`) does the same.
  */
 export declare const convertMessagePreview: (id: number, settings: unknown, report?: Reporter) => CABRootSection;

package/dist/transforms/postPurchase/convertProductInformation.d.ts

@@ -0,0 +1,4 @@
+import { CABOffersSection } from '../../schema/widgets/checkout-and-beyond/offers';
+import type { Reporter } from '../../server/shared';
+/** Structure only: the card provider binds the separately prepared fixed product. */
+export declare const convertProductInformation: (raw: unknown, report?: Reporter) => CABOffersSection[];

package/dist/transforms/postPurchase/imageContentSettings.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+/** Keep raw fields for local recovery and do not inject the full schema's placement default. */
+export declare const ImageContentSettings: z.ZodObject<{
+    superTitleSize: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+        small: "small";
+        default: "default";
+        base: "base";
+        large: "large";
+        medium: "medium";
+        xsmall: "xsmall";
+        xlarge: "xlarge";
+    }>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<string, unknown>>]>>;
+    titleSize: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+        small: "small";
+        default: "default";
+        base: "base";
+        large: "large";
+        medium: "medium";
+        xsmall: "xsmall";
+        xlarge: "xlarge";
+    }>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<string, unknown>>]>>;
+    descriptionSize: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+        small: "small";
+        default: "default";
+        base: "base";
+        large: "large";
+        medium: "medium";
+        xsmall: "xsmall";
+        xlarge: "xlarge";
+    }>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<string, unknown>>]>>;
+    horizontalAlignment: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+        center: "center";
+        leading: "leading";
+        trailing: "trailing";
+    }>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<string, unknown>>]>>;
+    swapContent: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodUnknown>;
+    description: z.ZodOptional<z.ZodUnknown>;
+    image: z.ZodOptional<z.ZodUnknown>;
+    imagePlacement: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
+        top: "top";
+        bottom: "bottom";
+        right: "right";
+        left: "left";
+    }>>>;
+    imageSize: z.ZodPipe<z.ZodDefault<z.ZodNumber>, z.ZodNumber>;
+    superTitle: z.ZodOptional<z.ZodUnknown>;
+    title: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type ImageContentSettings = z.infer<typeof ImageContentSettings>;

package/dist/transforms/postPurchase/sizeImageSource.d.ts

@@ -0,0 +1,2 @@
+/** Preserve legacy named-size removal independently of each image's fallback and requested size. */
+export declare const sizeImageSource: (source: string, size?: string) => string;

package/dist/transforms/postPurchase/types.d.ts

@@ -1,5 +1,11 @@
 import { WidgetType } from '../../schema/widgets/checkout-and-beyond/constants';
-/** A saved post-purchase message-block widget: `type` plus its ordered `blocks`, no `version` discriminator. */
+/**
+ * A saved post-purchase widget as `/cab/sections` sees it: `type` plus its ordered `blocks`, no `version`
+ * discriminator. This is the shape of EVERY `PostPurchaseSettings` (its `blocks` even default to three
+ * blocks), so the guard below claims every saved post-purchase widget by design — the section tree is the
+ * widget's presentation, and the non-block settings (`discount`, `products`, `integrations`, …) are read by
+ * the post-purchase session/Decision contracts, not converted into sections.
+ */
 export type V1PostPurchaseSettings = {
     blocks: unknown[];
     type: typeof WidgetType.shopify_post_purchase_extension;

package/package.json

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