@rebuy/rebuy 3.53.0 → 3.55.0

package/dist/server/normalizePostPurchaseCollection.d.ts

@@ -1,6 +1,15 @@
 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) => {
+import type { Reporter } from '../server/shared';
+/**
+ * Preserve the original capped positions before applying product-wide exclusions. `productLimit` caps raw
+ * positions, and a member's `productIndex` is its raw position: a product the schema dropped leaves its slot
+ * empty rather than promoting a product past the cap or renumbering the members after it. A source that sent
+ * products under the cap but whose every one the schema dropped is unreadable data, not an empty catalog (a
+ * survivor past the cap does not count): it throws the drops' `ZodError`, paths from the source root, exactly
+ * as the whole-source schema failed it before salvage, so a consumer's validation reporting still names the
+ * field.
+ */
+export declare const normalizePostPurchaseCollection: (settings: unknown, response: unknown, excludedProductIds?: PostPurchaseExcludedProductIds, report?: Reporter) => {
     members: {
         product: {
             title: string;

package/dist/server/normalizePostPurchaseProduct.d.ts

@@ -1,5 +1,264 @@
+import { z } from 'zod';
+import type { Reporter } from '../server/shared';
+/**
+ * The normalized read plus each surviving product's raw `productIndex`, which a collection publishes as member
+ * identity. `data` holds only the products the shared schema accepts; `report` hears each dropped one as drift.
+ * `dropped` is each rejected product's raw `productIndex` and zod issues.
+ */
+export declare const normalizePostPurchaseSource: (settings: unknown, response: unknown, report?: Reporter) => {
+    dropped: {
+        issues: z.core.$ZodIssue[];
+        productIndex: number;
+    }[];
+    normalized: {
+        data: {
+            title: string;
+            id: number;
+            productGroupVariants: unknown[];
+            sellingPlanGroups: {
+                requiresSellingPlan: boolean;
+                discountAmount?: unknown;
+                discountType?: unknown;
+                id?: unknown;
+                sellingPlans?: 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;
+        }[];
+        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" | "fixed_amount" | "percentage";
+                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" | "fixed_amount" | "percentage";
+                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;
+        };
+    };
+    products: {
+        product: {
+            title: string;
+            id: number;
+            productGroupVariants: unknown[];
+            sellingPlanGroups: {
+                requiresSellingPlan: boolean;
+                discountAmount?: unknown;
+                discountType?: unknown;
+                id?: unknown;
+                sellingPlans?: 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;
+        };
+        productIndex: number;
+    }[];
+};
 /** Both prepared purchase terms and display structure consume this one effective configuration. */
-export declare const normalizePostPurchaseProduct: (settings: unknown, response: unknown) => {
+export declare const normalizePostPurchaseProduct: (settings: unknown, response: unknown, report?: Reporter) => {
     data: {
         title: string;
         id: number;

package/dist/server/postPurchasePlanCatalog.d.ts

@@ -4,5 +4,10 @@ import type { Reporter } from '../server/shared';
 /**
  * Optional inspection data survives unsupported preparation without changing its purchase authority. Each plan
  * carries its own display saving on this variant's price, so the switch label needs no client maths.
+ *
+ * A catalog binds to exactly one variant, so callers that need plans narrow the product to the chosen variant first.
+ * A single product with several variants is a normal unnarrowed shape: it answers null without a drift report. Only
+ * genuinely malformed merchandise (no products, several products, no variants, a foreign variant) or unreadable plan
+ * data reports `Unreadable post-purchase plan catalog`.
  */
 export declare const projectPostPurchasePlanCatalog: (normalized: ReturnType<typeof normalizePostPurchaseProduct>, report?: Reporter) => PostPurchasePlanCatalog | null;

package/dist/server/readPostPurchaseProductSource.d.ts

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import type { Reporter } from '../server/shared';
+/**
+ * Reads a data-source response one product at a time (Slice 102): a product the shared schema rejects is
+ * dropped, not the whole source, so one bad product costs one card instead of the Offer. Each drop is a
+ * `product` drift naming the product id (when readable) and the first failing dotted path from the source
+ * root, e.g. `data.0.variants.0.price`, never a value; a reporter hears a response's drops once however many
+ * projections reread it, keyed on the `response` object itself: pass the same object to every projection of
+ * one request (a re-parse or clone per projection reports the drops again). The envelope (an object, `data`
+ * an array, readable `metadata`) still throws.
+ *
+ * Every survivor keeps `productIndex`, its position in the raw `data` array: Decision, Render and Offer
+ * members identify a product by that index, so a drop never renumbers the products after it. `dropped` keeps
+ * each drop's `productIndex` and its zod issues with paths from the source root, so a caller can fail a source
+ * whose every product failed exactly as the whole-source schema did before salvage.
+ */
+export declare const readPostPurchaseProductSource: (response: unknown, report?: Reporter) => {
+    dropped: {
+        issues: z.core.$ZodIssue[];
+        productIndex: number;
+    }[];
+    metadata: {
+        widget: Record<string, unknown>;
+    };
+    products: {
+        product: {
+            title: string;
+            id: number;
+            productGroupVariants: unknown[];
+            sellingPlanGroups: {
+                requiresSellingPlan: boolean;
+                discountAmount?: unknown;
+                discountType?: unknown;
+                id?: unknown;
+                sellingPlans?: 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;
+        };
+        productIndex: number;
+    }[];
+};

package/dist/server/shared.d.ts

@@ -27,7 +27,8 @@ export type UpstreamFetch = (path: string, params: Record<string, string>, optio
 }) => Promise<unknown>;
 /**
  * A drift signal the orchestrators emit when a per-item payload salvage drops something: a malformed
- * offer product, an invalid/unknown section stubbed out, an unreadable rule verdict, a shop-config
+ * offer product (or a post-purchase data-source product, `product`, named by id and dotted path), an
+ * invalid/unknown section stubbed out, an unreadable rule verdict, a shop-config
  * entry the shared schema inerted (`shopConfig`), unreadable selectable-gift milestones
  * (`giftMilestones` — the widget's gifts are then kept), or a post-purchase product's malformed selected review
  * metafield (`reviews` — the reviews are then omitted; it names the product and the field, never the value). Distinct from a hard {@link UpstreamError} — the

package/package.json

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