@rebuy/rebuy 3.34.0 → 3.35.0

package/dist/server/postPurchaseMemberEligibility.d.ts

@@ -0,0 +1,7 @@
+import type { PostPurchaseExcludedProductIds } from '../schema/postPurchaseProductCollectionView';
+import type { normalizePostPurchaseProduct } from '../server/normalizePostPurchaseProduct';
+/** The member's catalog is readable, but no variant is in stock. */
+export declare class PostPurchaseInventoryUnavailable extends Error {
+}
+/** Catalog facts only: preparation still owns defaults, quantity, terms, and presentation. */
+export declare const postPurchaseMemberEligibility: (normalized: ReturnType<typeof normalizePostPurchaseProduct>, product: ReturnType<typeof normalizePostPurchaseProduct>["data"][number], excluded?: PostPurchaseExcludedProductIds) => boolean;

package/dist/server/postPurchaseOfferCopy.d.ts

@@ -0,0 +1,3 @@
+import type { PostPurchaseProductSource } from '../schema/postPurchaseProductSource';
+/** Response copy belongs to this conversion and overrides only the first callout's truthy fields. */
+export declare const postPurchaseOfferCopy: (blocks: unknown[] | undefined, metadata: PostPurchaseProductSource["metadata"]) => unknown[] | undefined;

package/dist/server/postPurchaseProductEligibility.d.ts

@@ -1,8 +1,4 @@
 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;
+import type { PostPurchaseQuantity } from '../server/readPostPurchaseQuantity';
+/** The same eligibility rule drives advertised modes and their prepared terms. */
+export declare const oneTimeUnavailable: (normalized: ReturnType<typeof normalizePostPurchaseProduct>, allowCollection: boolean, quantity?: PostPurchaseQuantity) => "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/postPurchaseSubscriptionEligibility.d.ts

@@ -1,5 +1,4 @@
 import type { PostPurchasePlanOption } from '../schema/postPurchasePlanCatalog';
 import type { normalizePostPurchaseProduct } from '../server/normalizePostPurchaseProduct';
-export declare const subscriptionUnavailable: (normalized: ReturnType<typeof normalizePostPurchaseProduct>, plan: PostPurchasePlanOption | undefined, allowCollection: boolean, quantity?: {
-    quantity: number;
-}) => "An eligible subscription plan with supported shipping and discount is required" | undefined;
+import type { PostPurchaseQuantity } from '../server/readPostPurchaseQuantity';
+export declare const subscriptionUnavailable: (normalized: ReturnType<typeof normalizePostPurchaseProduct>, plan: PostPurchasePlanOption | undefined, allowCollection: boolean, quantity?: PostPurchaseQuantity) => "An eligible subscription plan with supported shipping and discount is required" | undefined;

package/dist/server/prepareNormalizedSubscription.d.ts

@@ -1,11 +1,10 @@
 import type { PostPurchasePlanOption } from '../schema/postPurchasePlanCatalog';
 import { type PostPurchasePreparation } from '../schema/postPurchaseProduct';
 import type { normalizePostPurchaseProduct } from '../server/normalizePostPurchaseProduct';
+import type { PostPurchaseQuantity } from '../server/readPostPurchaseQuantity';
 import type { Reporter } from '../server/shared';
 /**
  * Preparation for one allocated plan with validated configured shipping and discount. `report` is kept in the
  * frozen position for Slice 26, whose review projection is the only consumer inside `projectPostPurchaseProduct`.
  */
-export declare const prepareNormalizedSubscription: (normalized: ReturnType<typeof normalizePostPurchaseProduct>, report: Reporter | undefined, plan: PostPurchasePlanOption | undefined, quantity?: {
-    quantity: number;
-}, allowCollection?: boolean) => PostPurchasePreparation;
+export declare const prepareNormalizedSubscription: (normalized: ReturnType<typeof normalizePostPurchaseProduct>, report: Reporter | undefined, plan: PostPurchasePlanOption | undefined, quantity?: PostPurchaseQuantity, allowCollection?: boolean) => PostPurchasePreparation;

package/dist/server/preparePostPurchaseGroupDeclineDisplay.d.ts

@@ -0,0 +1,12 @@
+import type { PostPurchaseGroupSelection } from '../schema/postPurchaseGroupCatalog';
+import type { PostPurchaseExcludedProductIds } from '../schema/postPurchaseProductCollectionView';
+import type { PostPurchaseVariantSelector } from '../schema/postPurchaseVariantCatalog';
+/** Decline display validates association without requiring financial or plan eligibility. */
+export declare const preparePostPurchaseGroupDeclineDisplay: (settings: unknown, response: unknown, requested: PostPurchaseGroupSelection & PostPurchaseVariantSelector, excludedProductIds?: PostPurchaseExcludedProductIds) => {
+    display: {
+        productTitle: string;
+        variantId: number;
+        variantTitle: string;
+    };
+    productIndex: number;
+} | null;

package/dist/server/preparePostPurchaseOfferPresentation.d.ts

@@ -0,0 +1,137 @@
+import { type Reporter } from '../server/shared';
+/** An Offer frame consumes effective settings and metadata, never a purchasable product. */
+export declare const preparePostPurchaseOfferPresentation: (widgetId: number, settings: unknown, response: unknown, report?: Reporter) => {
+    labels: {
+        declineAll: string;
+        declineThisOffer: string;
+    };
+    layout: {
+        type: "grid" | "carousel" | "list";
+        itemsPerPage?: number | undefined;
+    };
+    sections: {
+        alignment: {
+            horizontal: "start" | "center" | "end";
+            vertical: "top" | "middle" | "bottom";
+        };
+        border: {
+            radius: "small" | "none" | "base" | "large" | "fullyRounded";
+            style: "none" | "base" | "dotted" | "dashed";
+            width: "base" | "medium" | "thick";
+        };
+        direction: "columns" | "rows" | "grid";
+        padding: "none" | "base" | "extraTight" | "tight" | "loose" | "extraLoose";
+        sectionId: string;
+        sections: never[] | import("..").CABSection[];
+        sectionType: "layout";
+        spacing: "none" | "base" | "extraTight" | "tight" | "loose" | "extraLoose";
+        width: number;
+        editorMode: "checkoutExtension" | "postPurchaseOffer" | "thankYouPage" | "orderStatusPage" | "ordersIndexPage" | "customerProfilePage";
+        previewMode: boolean;
+        storeId: number | null;
+        targetArea: {
+            icon: string;
+            label: string;
+            width: string;
+            fill?: boolean | undefined;
+            flip?: "vertical" | "horizontal" | "both" | undefined;
+        } | null;
+        tracking: {
+            enableAttribution: boolean;
+            enableSource: boolean;
+            enableWidget: boolean;
+        };
+        type: "product" | "bundle_builder" | "cart" | "cart_subscription" | "dynamic_bundle" | "gift_with_purchase" | "placeholder" | "pre_purchase" | "product_addon" | "product_upsell" | "recharge_checkout" | "recharge_customer_portal" | "recharge_post_purchase" | "shopify_checkout" | "shopify_checkout_extension" | "shopify_post_purchase" | "shopify_post_purchase_extension" | "switch_to_subscription" | "ui_extension_ad" | "ui_extension_button" | "ui_extension_content_block" | "ui_extension_line_item_editor" | "ui_extension_progress_bar";
+        uiLabels: {
+            currentPage: Record<string, string>;
+            guest: Record<string, string>;
+            loadingOptions: Record<string, string>;
+            nextPage: Record<string, string>;
+            offerCarousel: Record<string, string>;
+            offerDialog: Record<string, string>;
+            page: Record<string, string>;
+            previousPage: Record<string, string>;
+            selected: Record<string, string>;
+            subscriptionOptions: Record<string, string>;
+            updating: Record<string, string>;
+        };
+        version: 2;
+        widgetId: number | null;
+        buttonField?: "declineAllOffers" | "declineOffer" | "removeFromOrder" | "undoAddToOrder" | "activePage" | "addedToCart" | "addingToCart" | "addToCart" | "buttonLabel" | "destinationUrl" | "inactivePage" | "overlayContent" | "payNow" | "progressReached" | "progressRemaining" | "redirectToCheckout" | "showVariant" | "showVariants" | "soldOut" | "subscriptionOption" | "switchToOneTimePurchase" | "switchToSubscriptionNoDiscount" | "switchToSubscriptionWithDiscount" | undefined;
+        frame?: "callout" | "offer-content" | undefined;
+        grid?: {
+            columns: (string | number)[];
+            rows: (string | number)[];
+        } | undefined;
+        name?: string | undefined;
+        viewUrl?: string | undefined;
+        wrapping?: {
+            breakAt: number;
+            maxPerLine: number;
+        } | undefined;
+        mutators?: {
+            effect: "set_false" | "set_true" | "toggle";
+            variable: string;
+            when: {
+                operator: "is_empty" | "is_not_empty";
+                type: "content";
+            } | {
+                operator: "equals" | "greater_than" | "less_than";
+                type: "result_count";
+                value: number;
+            } | {
+                operator: "contains" | "does_not_contain";
+                type: "result_tag";
+                value: string;
+            } | {
+                event: "item_added" | "quantity_changed" | "variant_selected";
+                type: "event";
+            };
+        }[] | undefined;
+        variables?: ({
+            defaultValue: string;
+            name: string;
+            type: "text";
+            seed?: undefined;
+        } | {
+            defaultValue: number;
+            name: string;
+            type: "number";
+            seed?: undefined;
+        } | {
+            defaultValue: boolean;
+            name: string;
+            type: "boolean";
+            seed?: {
+                dataSourceId: number | null;
+                ruleset: {
+                    exitIfMatched: boolean;
+                    logic: {
+                        rules: {
+                            operator: "equals" | "greater_than" | "less_than" | "contains" | "does_not_contain" | "after" | "anything" | "before" | "contains_any" | "does_not_contain_any" | "does_not_equal";
+                            products: never[] | unknown[];
+                            type: "product" | "date" | "cart" | "cart_count" | "cart_item_count" | "cart_line_count" | "cart_subtotal" | "collection" | "customer" | "customer_order_count" | "customer_tag" | "customer_total_spent" | "product_tag" | "product_title" | "product_type" | "product_vendor";
+                            value: string;
+                        }[];
+                    }[];
+                    output: {
+                        key: string;
+                        type: "data_json";
+                        value: string;
+                    }[];
+                }[];
+            } | undefined;
+        })[] | undefined;
+        visibility?: {
+            variable: string;
+            visibleWhen: boolean;
+        } | undefined;
+        experiment?: {
+            elementId: number;
+            experimentId: number;
+            experimentType: string;
+            selectedId: number;
+        } | undefined;
+    } | null;
+    showDeclineAll?: "none" | "both" | "above" | "below" | undefined;
+};

package/dist/server/projectPostPurchaseProduct.d.ts

@@ -1,13 +1,11 @@
 import type { normalizePostPurchaseProduct } from '../server/normalizePostPurchaseProduct';
+import type { PostPurchaseQuantity } from '../server/readPostPurchaseQuantity';
 /**
- * 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.
+ * Both fixed purchase kinds project the same product and effective display after eligibility. Without a
+ * read quantity the selection falls back to `readPostPurchaseQuantity`'s initial quantity (metadata, then the
+ * picker default, then 1).
  */
-export declare const projectPostPurchaseProduct: ({ data, effective, metadata, original }: ReturnType<typeof normalizePostPurchaseProduct>, selectedQuantity?: {
-    quantity: number;
-}) => {
+export declare const projectPostPurchaseProduct: ({ data, effective, metadata, original }: ReturnType<typeof normalizePostPurchaseProduct>, selectedQuantity?: PostPurchaseQuantity) => {
     display: {
         discountedFrom: "price" | "compare_at_price";
         language: {

package/dist/server/readPostPurchaseGroup.d.ts

@@ -0,0 +1,101 @@
+import { PostPurchaseExcludedProductIds } from '../schema/postPurchaseProductCollectionView';
+import type { normalizePostPurchaseProduct } from '../server/normalizePostPurchaseProduct';
+/** Validate the flattened ownership boundary before applying merchandise-wide exclusions. */
+export declare const readPostPurchaseGroup: (product: ReturnType<typeof normalizePostPurchaseProduct>["data"][number], settings: ReturnType<typeof normalizePostPurchaseProduct>["effective"], excludedProductIds?: PostPurchaseExcludedProductIds) => {
+    catalog: {
+        memberProductId: number;
+        options: {
+            productId: number;
+            title: string;
+            variantCatalog: {
+                displayMode: "single" | "separate";
+                options: {
+                    name: string;
+                    values: string[];
+                    id: number;
+                    position: number;
+                }[];
+                productId: number;
+                showSelectors: boolean;
+                variants: {
+                    available: boolean;
+                    id: number;
+                    title: string;
+                    option1?: string | undefined;
+                    option2?: string | null | undefined;
+                    option3?: string | null | undefined;
+                    imageId?: number | null | undefined;
+                }[];
+            };
+        }[];
+    };
+    entries: {
+        product: {
+            images: {
+                id: number;
+                src: string;
+                alt?: string | undefined;
+            }[] | null | undefined;
+            productGroupVariants: never[];
+            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;
+            }[];
+            id: number;
+            title: string;
+            description: string | null;
+            image: {
+                src: string;
+            } | null;
+            options: {
+                name: string;
+                values: string[];
+                id: number;
+                position: number;
+            }[];
+            sellingPlanGroups: {
+                requiresSellingPlan: boolean;
+                discountAmount?: unknown;
+                discountType?: unknown;
+                id?: unknown;
+                sellingPlans?: unknown;
+            }[];
+            metadata?: {
+                productQuantity?: number | undefined;
+            } | undefined;
+            metafields?: unknown;
+            selectedVariant?: unknown;
+        };
+        variantCatalog: {
+            displayMode: "single" | "separate";
+            options: {
+                name: string;
+                values: string[];
+                id: number;
+                position: number;
+            }[];
+            productId: number;
+            showSelectors: boolean;
+            variants: {
+                available: boolean;
+                id: number;
+                title: string;
+                option1?: string | undefined;
+                option2?: string | null | undefined;
+                option3?: string | null | undefined;
+                imageId?: number | null | undefined;
+            }[];
+        };
+    }[];
+};

package/dist/server/readPostPurchaseGroupSelection.d.ts

@@ -0,0 +1,110 @@
+import { PostPurchaseGroupSelection } from '../schema/postPurchaseGroupCatalog';
+import type { PostPurchaseExcludedProductIds } from '../schema/postPurchaseProductCollectionView';
+/** Validated association and representative facts only; this reader grants no financial permission. */
+export declare const readPostPurchaseGroupSelection: (settings: unknown, response: unknown, requested: PostPurchaseGroupSelection, excludedProductIds?: PostPurchaseExcludedProductIds) => {
+    groupCatalog: {
+        memberProductId: number;
+        options: {
+            productId: number;
+            title: string;
+            variantCatalog: {
+                displayMode: "single" | "separate";
+                options: {
+                    name: string;
+                    values: string[];
+                    id: number;
+                    position: number;
+                }[];
+                productId: number;
+                showSelectors: boolean;
+                variants: {
+                    available: boolean;
+                    id: number;
+                    title: string;
+                    option1?: string | undefined;
+                    option2?: string | null | undefined;
+                    option3?: string | null | undefined;
+                    imageId?: number | null | undefined;
+                }[];
+            };
+        }[];
+    };
+    memberProductId: number;
+    productIndex: number;
+    reportingProduct: {
+        id: number;
+        title: string;
+    };
+    response: {
+        data: {
+            images: {
+                id: number;
+                src: string;
+                alt?: string | undefined;
+            }[] | null | undefined;
+            productGroupVariants: never[];
+            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;
+            }[];
+            id: number;
+            title: string;
+            description: string | null;
+            image: {
+                src: string;
+            } | null;
+            options: {
+                name: string;
+                values: string[];
+                id: number;
+                position: number;
+            }[];
+            sellingPlanGroups: {
+                requiresSellingPlan: boolean;
+                discountAmount?: unknown;
+                discountType?: unknown;
+                id?: unknown;
+                sellingPlans?: unknown;
+            }[];
+            metadata?: {
+                productQuantity?: number | undefined;
+            } | undefined;
+            metafields?: unknown;
+            selectedVariant?: unknown;
+        }[];
+        metadata: {
+            widget: Record<string, unknown>;
+        };
+    };
+    variantCatalog: {
+        displayMode: "single" | "separate";
+        options: {
+            name: string;
+            values: string[];
+            id: number;
+            position: number;
+        }[];
+        productId: number;
+        showSelectors: boolean;
+        variants: {
+            available: boolean;
+            id: number;
+            title: string;
+            option1?: string | undefined;
+            option2?: string | null | undefined;
+            option3?: string | null | undefined;
+            imageId?: number | null | undefined;
+        }[];
+    };
+} | null;

package/dist/server/readPostPurchaseQuantity.d.ts

@@ -0,0 +1,27 @@
+import type { normalizePostPurchaseProduct } from '../server/normalizePostPurchaseProduct';
+/** The configured policy is valid, but this selection cannot be prepared. */
+export declare class PostPurchaseQuantityUnavailable extends Error {
+}
+/**
+ * The initial quantity is the first product's metadata override, else the original picker default (1 when the
+ * picker is off; empty data has no override), and is never clamped; an explicit buyer choice must satisfy
+ * today's effective bounds. The metadata override is flagged new behaviour (decision 15, L82): legacy's schema
+ * stripped it. An admission's
+ * `expectedQuantity` equal to the initial quantity is identity, not a new choice. A disabled picker's
+ * configured default and bounds are ignored, as legacy ignored them: its policy is fixed at the initial
+ * quantity, so leftover junk such as a `null` minimum cannot refuse the Offer.
+ */
+export declare const readPostPurchaseQuantity: ({ data, effective, original, }: Pick<ReturnType<typeof normalizePostPurchaseProduct>, "data" | "effective" | "original">, selection: {
+    quantity: number | undefined;
+} | {
+    expectedQuantity: number;
+}) => {
+    policy: {
+        enabled: boolean;
+        initialQuantity: number;
+        maxValue: number;
+        minValue: number;
+    };
+    quantity: number;
+};
+export type PostPurchaseQuantity = ReturnType<typeof readPostPurchaseQuantity>;

package/dist/server/resolvePostPurchaseMemberDefault.d.ts

@@ -0,0 +1,8 @@
+import { PostPurchaseVariantDefaultContext } from '../schema/postPurchaseVariantDefaultContext';
+import type { normalizePostPurchaseProduct } from '../server/normalizePostPurchaseProduct';
+/**
+ * Matching alone consumes original attributes; recommendation and explicit preselection need no enrichment. Absent
+ * enrichment (rebuy-api's line-item read is optional) skips matching and keeps the unmatched default; present but
+ * malformed enrichment still throws.
+ */
+export declare const resolvePostPurchaseMemberDefault: (product: ReturnType<typeof normalizePostPurchaseProduct>["data"][number], original: ReturnType<typeof normalizePostPurchaseProduct>["original"], context: PostPurchaseVariantDefaultContext) => number;

package/dist/server/selectPostPurchaseChoice.d.ts

@@ -1,13 +1,12 @@
 import { type PostPurchaseChoice } from '../schema/postPurchaseChoice';
 import type { PostPurchasePlanCatalog } from '../schema/postPurchasePlanCatalog';
 import type { normalizePostPurchaseProduct } from '../server/normalizePostPurchaseProduct';
+import type { PostPurchaseQuantity } from '../server/readPostPurchaseQuantity';
 /**
  * Catalog inspection is not authority; the chosen mode still passes its complete preparation guards. A catalog
  * projected for another product or variant is treated as absent, so a stale catalog never lends its plans.
  */
-export declare const selectPostPurchaseChoice: (normalized: ReturnType<typeof normalizePostPurchaseProduct>, projected: PostPurchasePlanCatalog | null, requested: PostPurchaseChoice | undefined, allowCollection: boolean, quantity?: {
-    quantity: number;
-}) => {
+export declare const selectPostPurchaseChoice: (normalized: ReturnType<typeof normalizePostPurchaseProduct>, projected: PostPurchasePlanCatalog | null, requested: PostPurchaseChoice | undefined, allowCollection: boolean, quantity?: PostPurchaseQuantity) => {
     choice: undefined;
     options: undefined;
     plan: undefined;

package/package.json

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