@rebuy/rebuy 3.29.1 → 3.30.0

package/dist/server/normalizePostPurchaseCollection.d.ts

@@ -0,0 +1,250 @@
+import { PostPurchaseExcludedProductIds } from '../schema/postPurchaseProductCollectionView';
+/** Preserve the original capped positions before applying product-wide exclusions. */
+export declare const normalizePostPurchaseCollection: (settings: unknown, response: unknown, excludedProductIds?: PostPurchaseExcludedProductIds) => {
+    members: {
+        product: {
+            title: string;
+            id: number;
+            productGroupVariants: unknown[];
+            variants: {
+                title: string;
+                compareAtPrice: string | null;
+                id: number;
+                inventoryManagement: string | null;
+                inventoryPolicy: string;
+                inventoryQuantity: number;
+                price: string;
+                productId: number;
+                imageId?: number | null | undefined;
+                option1?: unknown;
+                option2?: unknown;
+                option3?: unknown;
+                sellingPlanAllocations?: unknown;
+            }[];
+            image?: {
+                src: string;
+            } | null | undefined;
+            description?: string | null | undefined;
+            images?: {
+                id: number;
+                src: string;
+                alt?: string | undefined;
+            }[] | null | undefined;
+            metadata?: {
+                productQuantity?: number | undefined;
+            } | undefined;
+            metafields?: unknown;
+            options?: unknown;
+            selectedVariant?: unknown;
+            sellingPlanGroups?: {
+                requiresSellingPlan?: boolean | undefined;
+                discountAmount?: unknown;
+                discountType?: unknown;
+                id?: unknown;
+                sellingPlans?: unknown;
+            }[] | undefined;
+        };
+        productIndex: number;
+    }[];
+    normalized: {
+        data: {
+            title: string;
+            id: number;
+            productGroupVariants: unknown[];
+            variants: {
+                title: string;
+                compareAtPrice: string | null;
+                id: number;
+                inventoryManagement: string | null;
+                inventoryPolicy: string;
+                inventoryQuantity: number;
+                price: string;
+                productId: number;
+                imageId?: number | null | undefined;
+                option1?: unknown;
+                option2?: unknown;
+                option3?: unknown;
+                sellingPlanAllocations?: unknown;
+            }[];
+            image?: {
+                src: string;
+            } | null | undefined;
+            description?: string | null | undefined;
+            images?: {
+                id: number;
+                src: string;
+                alt?: string | undefined;
+            }[] | null | undefined;
+            metadata?: {
+                productQuantity?: number | undefined;
+            } | undefined;
+            metafields?: unknown;
+            options?: unknown;
+            selectedVariant?: unknown;
+            sellingPlanGroups?: {
+                requiresSellingPlan?: boolean | undefined;
+                discountAmount?: unknown;
+                discountType?: unknown;
+                id?: unknown;
+                sellingPlans?: unknown;
+            }[] | undefined;
+        }[];
+        effective: {
+            language: {
+                description: string;
+                descriptionEnabled: boolean;
+                displayCtaPrice: boolean;
+                global: {
+                    declineAll: string;
+                    declineThisOffer: string;
+                    free: string;
+                    notAvailable: string;
+                    payNow: string;
+                    payNowUpgradeToSubscription: string;
+                    quantity: string;
+                    recurringShipping: string;
+                    recurringSubtotal: string;
+                    reviewsPlural: string;
+                    reviewsSingular: string;
+                    save: string;
+                    shipping: string;
+                    subscriptionOption: string;
+                    subtotal: string;
+                    taxes: string;
+                    total: string;
+                };
+                globalTranslation: string;
+                descriptionRte?: {
+                    content: unknown[];
+                    type: string;
+                } | undefined;
+                descriptionSpacing?: "default" | "none" | "tight" | "loose" | "xtight" | "xloose" | undefined;
+            };
+            productType: string;
+            discountedFrom: "price" | "compare_at_price";
+            productLimit: number;
+            productOptions: {
+                hideOutOfStockVariants: boolean;
+                matchVariant: boolean;
+                showShipping: boolean;
+                showSubtotal: boolean;
+                showTaxes: boolean;
+                showTotal: boolean;
+                showVariantSelectors: boolean;
+                variantSelectorDisplayMode: "single" | "separate";
+                showDeclineAll?: "none" | "both" | "above" | "below" | undefined;
+            };
+            productTypeSelector: "radio" | "dropdown";
+            quantityInputs: {
+                defaultQuantity: number;
+                enabled: boolean;
+                maxValue: number;
+                minValue: number;
+            };
+            upgradeToSubscription: {
+                acceptButtonText: string;
+                allow: boolean;
+                emailRefundNotice: boolean;
+                errorBannerText: string;
+            };
+            advance: unknown;
+            discount: {
+                shouldShowSavingText: boolean;
+                type: "none" | "percentage" | "fixed_amount";
+                amount: number;
+            };
+            integrations: unknown;
+            shipping: {
+                enabled: boolean;
+                title: string;
+                type: "fixed_amount" | "free";
+                amount: number;
+            };
+            styles: unknown;
+            subImages: number | null;
+            subscription: unknown;
+            subscriptionIsDefault?: boolean | undefined;
+            blocks?: unknown[] | undefined;
+        };
+        metadata: {
+            widget: Record<string, unknown>;
+        };
+        original: {
+            language: {
+                description: string;
+                descriptionEnabled: boolean;
+                displayCtaPrice: boolean;
+                global: {
+                    declineAll: string;
+                    declineThisOffer: string;
+                    free: string;
+                    notAvailable: string;
+                    payNow: string;
+                    payNowUpgradeToSubscription: string;
+                    quantity: string;
+                    recurringShipping: string;
+                    recurringSubtotal: string;
+                    reviewsPlural: string;
+                    reviewsSingular: string;
+                    save: string;
+                    shipping: string;
+                    subscriptionOption: string;
+                    subtotal: string;
+                    taxes: string;
+                    total: string;
+                };
+                globalTranslation: string;
+                descriptionRte?: {
+                    content: unknown[];
+                    type: string;
+                } | undefined;
+                descriptionSpacing?: "default" | "none" | "tight" | "loose" | "xtight" | "xloose" | undefined;
+            };
+            productType: string;
+            discountedFrom: "price" | "compare_at_price";
+            productLimit: number;
+            productOptions: {
+                hideOutOfStockVariants: boolean;
+                matchVariant: boolean;
+                showShipping: boolean;
+                showSubtotal: boolean;
+                showTaxes: boolean;
+                showTotal: boolean;
+                showVariantSelectors: boolean;
+                variantSelectorDisplayMode: "single" | "separate";
+                showDeclineAll?: "none" | "both" | "above" | "below" | undefined;
+            };
+            productTypeSelector: "radio" | "dropdown";
+            quantityInputs: {
+                defaultQuantity: number;
+                enabled: boolean;
+                maxValue: number;
+                minValue: number;
+            };
+            upgradeToSubscription: {
+                acceptButtonText: string;
+                allow: boolean;
+                emailRefundNotice: boolean;
+                errorBannerText: string;
+            };
+            advance: unknown;
+            discount: {
+                shouldShowSavingText: boolean;
+                type: "none" | "percentage" | "fixed_amount";
+                amount: number;
+            };
+            integrations: unknown;
+            shipping: {
+                enabled: boolean;
+                title: string;
+                type: "fixed_amount" | "free";
+                amount: number;
+            };
+            styles: unknown;
+            subImages: number | null;
+            subscription: unknown;
+            subscriptionIsDefault?: boolean | undefined;
+            blocks?: unknown[] | undefined;
+        };
+    };
+};

package/dist/server/normalizePostPurchaseProduct.d.ts

@@ -0,0 +1,202 @@
+/** Both prepared purchase terms and display structure consume this one effective configuration. */
+export declare const normalizePostPurchaseProduct: (settings: unknown, response: unknown) => {
+    data: {
+        title: string;
+        id: number;
+        productGroupVariants: unknown[];
+        variants: {
+            title: string;
+            compareAtPrice: string | null;
+            id: number;
+            inventoryManagement: string | null;
+            inventoryPolicy: string;
+            inventoryQuantity: number;
+            price: string;
+            productId: number;
+            imageId?: number | null | undefined;
+            option1?: unknown;
+            option2?: unknown;
+            option3?: unknown;
+            sellingPlanAllocations?: unknown;
+        }[];
+        image?: {
+            src: string;
+        } | null | undefined;
+        description?: string | null | undefined;
+        images?: {
+            id: number;
+            src: string;
+            alt?: string | undefined;
+        }[] | null | undefined;
+        metadata?: {
+            productQuantity?: number | undefined;
+        } | undefined;
+        metafields?: unknown;
+        options?: unknown;
+        selectedVariant?: unknown;
+        sellingPlanGroups?: {
+            requiresSellingPlan?: boolean | undefined;
+            discountAmount?: unknown;
+            discountType?: unknown;
+            id?: unknown;
+            sellingPlans?: unknown;
+        }[] | undefined;
+    }[];
+    effective: {
+        language: {
+            description: string;
+            descriptionEnabled: boolean;
+            displayCtaPrice: boolean;
+            global: {
+                declineAll: string;
+                declineThisOffer: string;
+                free: string;
+                notAvailable: string;
+                payNow: string;
+                payNowUpgradeToSubscription: string;
+                quantity: string;
+                recurringShipping: string;
+                recurringSubtotal: string;
+                reviewsPlural: string;
+                reviewsSingular: string;
+                save: string;
+                shipping: string;
+                subscriptionOption: string;
+                subtotal: string;
+                taxes: string;
+                total: string;
+            };
+            globalTranslation: string;
+            descriptionRte?: {
+                content: unknown[];
+                type: string;
+            } | undefined;
+            descriptionSpacing?: "default" | "none" | "tight" | "loose" | "xtight" | "xloose" | undefined;
+        };
+        productType: string;
+        discountedFrom: "price" | "compare_at_price";
+        productLimit: number;
+        productOptions: {
+            hideOutOfStockVariants: boolean;
+            matchVariant: boolean;
+            showShipping: boolean;
+            showSubtotal: boolean;
+            showTaxes: boolean;
+            showTotal: boolean;
+            showVariantSelectors: boolean;
+            variantSelectorDisplayMode: "single" | "separate";
+            showDeclineAll?: "none" | "both" | "above" | "below" | undefined;
+        };
+        productTypeSelector: "radio" | "dropdown";
+        quantityInputs: {
+            defaultQuantity: number;
+            enabled: boolean;
+            maxValue: number;
+            minValue: number;
+        };
+        upgradeToSubscription: {
+            acceptButtonText: string;
+            allow: boolean;
+            emailRefundNotice: boolean;
+            errorBannerText: string;
+        };
+        advance: unknown;
+        discount: {
+            shouldShowSavingText: boolean;
+            type: "none" | "percentage" | "fixed_amount";
+            amount: number;
+        };
+        integrations: unknown;
+        shipping: {
+            enabled: boolean;
+            title: string;
+            type: "fixed_amount" | "free";
+            amount: number;
+        };
+        styles: unknown;
+        subImages: number | null;
+        subscription: unknown;
+        subscriptionIsDefault?: boolean | undefined;
+        blocks?: unknown[] | undefined;
+    };
+    metadata: {
+        widget: Record<string, unknown>;
+    };
+    original: {
+        language: {
+            description: string;
+            descriptionEnabled: boolean;
+            displayCtaPrice: boolean;
+            global: {
+                declineAll: string;
+                declineThisOffer: string;
+                free: string;
+                notAvailable: string;
+                payNow: string;
+                payNowUpgradeToSubscription: string;
+                quantity: string;
+                recurringShipping: string;
+                recurringSubtotal: string;
+                reviewsPlural: string;
+                reviewsSingular: string;
+                save: string;
+                shipping: string;
+                subscriptionOption: string;
+                subtotal: string;
+                taxes: string;
+                total: string;
+            };
+            globalTranslation: string;
+            descriptionRte?: {
+                content: unknown[];
+                type: string;
+            } | undefined;
+            descriptionSpacing?: "default" | "none" | "tight" | "loose" | "xtight" | "xloose" | undefined;
+        };
+        productType: string;
+        discountedFrom: "price" | "compare_at_price";
+        productLimit: number;
+        productOptions: {
+            hideOutOfStockVariants: boolean;
+            matchVariant: boolean;
+            showShipping: boolean;
+            showSubtotal: boolean;
+            showTaxes: boolean;
+            showTotal: boolean;
+            showVariantSelectors: boolean;
+            variantSelectorDisplayMode: "single" | "separate";
+            showDeclineAll?: "none" | "both" | "above" | "below" | undefined;
+        };
+        productTypeSelector: "radio" | "dropdown";
+        quantityInputs: {
+            defaultQuantity: number;
+            enabled: boolean;
+            maxValue: number;
+            minValue: number;
+        };
+        upgradeToSubscription: {
+            acceptButtonText: string;
+            allow: boolean;
+            emailRefundNotice: boolean;
+            errorBannerText: string;
+        };
+        advance: unknown;
+        discount: {
+            shouldShowSavingText: boolean;
+            type: "none" | "percentage" | "fixed_amount";
+            amount: number;
+        };
+        integrations: unknown;
+        shipping: {
+            enabled: boolean;
+            title: string;
+            type: "fixed_amount" | "free";
+            amount: number;
+        };
+        styles: unknown;
+        subImages: number | null;
+        subscription: unknown;
+        subscriptionIsDefault?: boolean | undefined;
+        blocks?: unknown[] | undefined;
+    };
+};

package/dist/server/postPurchasePrimaryImage.d.ts

@@ -0,0 +1,6 @@
+import type { PostPurchaseProductSource } from '../schema/postPurchaseProductSource';
+/** Preserve legacy sizeImage(..., '800x800') and its no-image asset at the display boundary (L92). */
+export declare const postPurchasePrimaryImage: (product: PostPurchaseProductSource["data"][number]) => {
+    description: string;
+    source: string;
+};

package/dist/server/postPurchaseProductDisplay.d.ts

@@ -0,0 +1,41 @@
+import type { PostPurchaseProductSettings } from '../schema/postPurchaseProductSettings';
+import type { PostPurchaseProductSource } from '../schema/postPurchaseProductSource';
+/**
+ * Keep response-description provenance: it precedes merchant RTE even after settings are merged. Reviews
+ * are Slice 26's addition (see `postPurchaseProductDisplay` schema); nothing here computes them yet.
+ */
+export declare const projectPostPurchaseProductDisplay: (effective: PostPurchaseProductSettings, metadata: PostPurchaseProductSource["metadata"], product: PostPurchaseProductSource["data"][number]) => {
+    discountedFrom: "price" | "compare_at_price";
+    language: {
+        description: string;
+        descriptionEnabled: boolean;
+        descriptionRte?: {
+            content: unknown[];
+            type: string;
+        } | undefined;
+        descriptionSpacing?: "default" | "none" | "tight" | "loose" | "xtight" | "xloose" | undefined;
+    };
+    primaryImage: {
+        description: string;
+        source: string;
+    };
+    productOptions: {
+        showShipping: boolean;
+        showSubtotal: boolean;
+        showTaxes: boolean;
+        showTotal: boolean;
+        showVariantSelectors: boolean;
+        showDeclineAll?: "none" | "both" | "above" | "below" | undefined;
+    };
+    responseDescription: string;
+    shouldShowSavingText: boolean;
+    gallery?: {
+        images: {
+            description: string;
+            id: number;
+            source: string;
+            thumbnail: string;
+        }[];
+        selectedImageId?: number | undefined;
+    } | undefined;
+};

package/dist/server/postPurchaseProductEligibility.d.ts

@@ -0,0 +1,8 @@
+import type { normalizePostPurchaseProduct } from '../server/normalizePostPurchaseProduct';
+/**
+ * The same eligibility rule drives advertised modes and their prepared terms. `quantity` is typed
+ * structurally, matching `projectPostPurchaseProduct` (see its comment) — only truthiness is read here.
+ */
+export declare const oneTimeUnavailable: (normalized: ReturnType<typeof normalizePostPurchaseProduct>, allowCollection: boolean, quantity?: {
+    quantity: number;
+}) => "Only one fixed product and variant are supported" | "Only fixed one-time configuration is supported" | "An available one-time variant without product groups is required" | undefined;

package/dist/server/postPurchaseProductGallery.d.ts

@@ -0,0 +1,5 @@
+import type { PostPurchaseProductGallery } from '../schema/postPurchaseProductGallery';
+import type { PostPurchaseProductSettings } from '../schema/postPurchaseProductSettings';
+import type { PostPurchaseProductSource } from '../schema/postPurchaseProductSource';
+/** Display-only catalog facts (L67); a selected image may lie outside the configured thumbnail limit. */
+export declare const postPurchaseProductGallery: (product: PostPurchaseProductSource["data"][number], limit: PostPurchaseProductSettings["subImages"]) => PostPurchaseProductGallery;

package/dist/server/postPurchaseVariantAvailable.d.ts

@@ -0,0 +1,12 @@
+import type { PostPurchaseProductSource } from '../schema/postPurchaseProductSource';
+type Inventory = Pick<PostPurchaseProductSource['data'][number]['variants'][number], 'inventoryManagement' | 'inventoryPolicy' | 'inventoryQuantity'>;
+/**
+ * The single availability definition legacy split across `initializeProduct` and `getIsOutOfStock` (L83).
+ * L84 (the unguarded `inventoryPolicy.toLowerCase()` that threw on a managed variant carrying no policy) is
+ * resolved at the parse boundary, not here: `PostPurchaseProductSource` requires the policy, so such a
+ * variant is rejected cleanly — the same "dropped, not crashed on" contract as `OfferProduct` — and this
+ * helper only ever sees a string. The attribute matcher's stock filter is the one deliberate exception
+ * (see `matchPostPurchaseVariantDefault`).
+ */
+export declare const postPurchaseVariantAvailable: (variant: Inventory) => boolean;
+export {};

package/dist/server/postPurchaseVariantCatalog.d.ts

@@ -0,0 +1,3 @@
+import { PostPurchaseVariantCatalog } from '../schema/postPurchaseVariantCatalog';
+import type { normalizePostPurchaseProduct } from '../server/normalizePostPurchaseProduct';
+export declare const projectPostPurchaseVariantCatalog: (product: ReturnType<typeof normalizePostPurchaseProduct>["data"][number], settings: ReturnType<typeof normalizePostPurchaseProduct>["effective"]) => PostPurchaseVariantCatalog;

package/dist/server/projectPostPurchaseProduct.d.ts

@@ -0,0 +1,127 @@
+import type { normalizePostPurchaseProduct } from '../server/normalizePostPurchaseProduct';
+/**
+ * Both fixed purchase kinds project the same product and effective display after eligibility.
+ * `selectedQuantity` is typed structurally rather than as `ReturnType<typeof readPostPurchaseQuantity>`
+ * (Slice 25's `readPostPurchaseQuantity` is not part of this Slice) — only `.quantity` is read here, so
+ * the narrower shape is behaviourally identical and adds no forward dependency.
+ */
+export declare const projectPostPurchaseProduct: ({ data, effective, metadata, original }: ReturnType<typeof normalizePostPurchaseProduct>, selectedQuantity?: {
+    quantity: number;
+}) => {
+    display: {
+        discountedFrom: "price" | "compare_at_price";
+        language: {
+            description: string;
+            descriptionEnabled: boolean;
+            descriptionRte?: {
+                content: unknown[];
+                type: string;
+            } | undefined;
+            descriptionSpacing?: "default" | "none" | "tight" | "loose" | "xtight" | "xloose" | undefined;
+        };
+        primaryImage: {
+            description: string;
+            source: string;
+        };
+        productOptions: {
+            showShipping: boolean;
+            showSubtotal: boolean;
+            showTaxes: boolean;
+            showTotal: boolean;
+            showVariantSelectors: boolean;
+            showDeclineAll?: "none" | "both" | "above" | "below" | undefined;
+        };
+        responseDescription: string;
+        shouldShowSavingText: boolean;
+        gallery?: {
+            images: {
+                description: string;
+                id: number;
+                source: string;
+                thumbnail: string;
+            }[];
+            selectedImageId?: number | undefined;
+        } | undefined;
+    };
+    labels: {
+        declineAll: string;
+        declineThisOffer: string;
+        free: string;
+        notAvailable: string;
+        payNow: string;
+        payNowUpgradeToSubscription: string;
+        quantity: string;
+        recurringShipping: string;
+        recurringSubtotal: string;
+        reviewsPlural: string;
+        reviewsSingular: string;
+        save: string;
+        shipping: string;
+        subscriptionOption: string;
+        subtotal: string;
+        taxes: string;
+        total: string;
+    };
+    product: {
+        variant: {
+            title: string;
+            compareAtPrice: string | null;
+            id: number;
+            inventoryManagement: string | null;
+            inventoryPolicy: string;
+            inventoryQuantity: number;
+            price: string;
+            productId: number;
+            imageId?: number | null | undefined;
+            option1?: unknown;
+            option2?: unknown;
+            option3?: unknown;
+            sellingPlanAllocations?: unknown;
+        };
+        title: string;
+        id: number;
+        productGroupVariants: unknown[];
+        variants: {
+            title: string;
+            compareAtPrice: string | null;
+            id: number;
+            inventoryManagement: string | null;
+            inventoryPolicy: string;
+            inventoryQuantity: number;
+            price: string;
+            productId: number;
+            imageId?: number | null | undefined;
+            option1?: unknown;
+            option2?: unknown;
+            option3?: unknown;
+            sellingPlanAllocations?: unknown;
+        }[];
+        image?: {
+            src: string;
+        } | null | undefined;
+        description?: string | null | undefined;
+        images?: {
+            id: number;
+            src: string;
+            alt?: string | undefined;
+        }[] | null | undefined;
+        metadata?: {
+            productQuantity?: number | undefined;
+        } | undefined;
+        metafields?: unknown;
+        options?: unknown;
+        selectedVariant?: unknown;
+        sellingPlanGroups?: {
+            requiresSellingPlan?: boolean | undefined;
+            discountAmount?: unknown;
+            discountType?: unknown;
+            id?: unknown;
+            sellingPlans?: unknown;
+        }[] | undefined;
+    };
+    selection: {
+        productId: number;
+        quantity: number;
+        variantId: number;
+    };
+};

package/dist/server/resolvePostPurchaseVariantDefault.d.ts

@@ -0,0 +1,10 @@
+import type { z } from 'zod';
+import { PostPurchaseOrderAttributes, PostPurchaseVariantDefaultProduct, PostPurchaseVariantDefaultSettings } from '../schema/postPurchaseVariantDefault';
+/**
+ * Initial defaults only: explicit buyer selection bypasses this resolver; no purchase authority is
+ * returned. L78's order is `variants[0] → attribute match → first in stock` — its "v2 recommendation"
+ * step between the match and the fallback is not ported (decision 15): the legacy schema it read
+ * `recommendedVariantIds` through stripped the field before any reader ran, so that step never fired
+ * against real data and the observable order is unchanged by dropping it.
+ */
+export declare const resolvePostPurchaseVariantDefault: (source: z.input<typeof PostPurchaseVariantDefaultProduct>, settings: z.input<typeof PostPurchaseVariantDefaultSettings>, originalAttributes?: z.input<typeof PostPurchaseOrderAttributes>) => number;

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

@@ -40,8 +40,8 @@ export declare const ImageContentSettings: z.ZodObject<{
     imagePlacement: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
         top: "top";
         bottom: "bottom";
-        right: "right";
         left: "left";
+        right: "right";
     }>>>;
     imageSize: z.ZodPipe<z.ZodDefault<z.ZodNumber>, z.ZodNumber>;
     superTitle: z.ZodOptional<z.ZodUnknown>;