@rebuy/rebuy 3.41.0 → 3.43.0

package/dist/schema/index.d.ts

@@ -10,6 +10,7 @@ export * from './postPurchaseClassification';
 export * from './postPurchaseDecline';
 export * from './postPurchaseDeclineDelivery';
 export * from './postPurchaseDiscount';
+export * from './postPurchaseDisplayPrice';
 export * from './postPurchaseEligibility';
 export * from './postPurchaseExitPolicy';
 export * from './postPurchaseFinish';
@@ -55,6 +56,7 @@ export * from './postPurchaseSubscription';
 export * from './postPurchaseSubscriptionDisplay';
 export { PreparedPostPurchaseSubscription } from './postPurchaseSubscriptionProduct';
 export * from './postPurchaseTransition';
+export * from './postPurchaseUpgrade';
 export * from './postPurchaseVariantCatalog';
 export * from './postPurchaseVariantDefault';
 export * from './postPurchaseVariantDefaultContext';

package/dist/schema/postPurchaseAdmission.d.ts

@@ -1,4 +1,12 @@
 import { z } from 'zod';
+/**
+ * Absent means `purchase`, so every pre-upgrade wire is unchanged. `upgrade` adds the selected subscription and
+ * refunds the buyer's original one-time line of the same variant; the server binds that line, never the client.
+ */
+export declare const PurchaseAdmissionModeSchema: z.ZodEnum<{
+    purchase: "purchase";
+    upgrade: "upgrade";
+}>;
 export declare const PurchaseExpectedSchema: z.ZodObject<{
     buyerConsentToSubscriptions: z.ZodOptional<z.ZodBoolean>;
     changeset: z.ZodObject<{
@@ -52,6 +60,10 @@ export declare const PurchaseExpectedSchema: z.ZodObject<{
         productId: z.ZodNumber;
         productIndex: z.ZodNumber;
     }, z.core.$strict>>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        purchase: "purchase";
+        upgrade: "upgrade";
+    }>>;
     progressRevision: z.ZodOptional<z.ZodNumber>;
     selection: z.ZodObject<{
         productId: z.ZodNumber;
@@ -116,6 +128,10 @@ export declare const PurchaseRequestSchema: z.ZodObject<{
             productId: z.ZodNumber;
             productIndex: z.ZodNumber;
         }, z.core.$strict>>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            purchase: "purchase";
+            upgrade: "upgrade";
+        }>>;
         progressRevision: z.ZodOptional<z.ZodNumber>;
         selection: z.ZodObject<{
             productId: z.ZodNumber;
@@ -129,7 +145,15 @@ export declare const PurchaseRequestSchema: z.ZodObject<{
 export declare const PurchaseReceiptSchema: z.ZodObject<{
     admittedAt: z.ZodNumber;
     changesetToken: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<{
+        purchase: "purchase";
+        upgrade: "upgrade";
+    }>>;
     operationId: z.ZodUUID;
+    originalLine: z.ZodOptional<z.ZodObject<{
+        quantity: z.ZodNumber;
+        variantId: z.ZodNumber;
+    }, z.core.$strict>>;
     requiresSubscriptionConsent: z.ZodBoolean;
     selection: z.ZodObject<{
         productId: z.ZodNumber;
@@ -142,7 +166,15 @@ export declare const PurchaseResponseSchema: z.ZodObject<{
     data: z.ZodObject<{
         admittedAt: z.ZodNumber;
         changesetToken: z.ZodString;
+        mode: z.ZodOptional<z.ZodEnum<{
+            purchase: "purchase";
+            upgrade: "upgrade";
+        }>>;
         operationId: z.ZodUUID;
+        originalLine: z.ZodOptional<z.ZodObject<{
+            quantity: z.ZodNumber;
+            variantId: z.ZodNumber;
+        }, z.core.$strict>>;
         requiresSubscriptionConsent: z.ZodBoolean;
         selection: z.ZodObject<{
             productId: z.ZodNumber;
@@ -156,3 +188,4 @@ export declare const PurchaseResponseSchema: z.ZodObject<{
 export type PurchaseReceipt = z.infer<typeof PurchaseReceiptSchema>;
 export type PurchaseExpected = z.infer<typeof PurchaseExpectedSchema>;
 export type PurchaseRequest = z.infer<typeof PurchaseRequestSchema>;
+export type PurchaseAdmissionMode = z.infer<typeof PurchaseAdmissionModeSchema>;

package/dist/schema/postPurchaseDisplayPrice.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+/**
+ * Display pricing rebuy-api works out for the current choice (legacy discount maths, L132–L140), so the client
+ * only formats minor units into cab-checkout's tokens: `variantPriceMinor` → `{{variantPrice}}` (× quantity →
+ * `{{variantTotalPrice}}`), `variantCompareAtPriceMinor` → `{{variantCompareAtPrice}}` (null: nothing struck,
+ * the exemplar's ''). The saving is the struck price minus the price; `savingFormat` is which of
+ * `savingMinor` / `savingPercent` the saving text shows (L140: currency for a fixed amount). A plan choice also
+ * carries `postPurchaseSubscriptionDisplay`'s unit estimate, which must restate these facts: with the saving tied
+ * to its own comparison, its comparison is the struck price when one is struck and at most the price when none is
+ * (a plan `price` above the regular price compares below it, so equality to the price would be too strict). A
+ * display estimate, never Shopify's charge.
+ */
+export declare const PostPurchaseDisplayPrice: z.ZodObject<{
+    currencyCode: z.ZodString;
+    savingFormat: z.ZodEnum<{
+        amount: "amount";
+        percent: "percent";
+    }>;
+    savingMinor: z.ZodNumber;
+    savingPercent: z.ZodNumber;
+    subscriptionUnit: z.ZodOptional<z.ZodObject<{
+        comparisonMinor: z.ZodNumber;
+        currencyCode: z.ZodString;
+        priceMinor: z.ZodNumber;
+        savingMinor: z.ZodNumber;
+        savingPercent: z.ZodNumber;
+    }, z.core.$strip>>;
+    variantCompareAtPriceMinor: z.ZodNullable<z.ZodNumber>;
+    variantPriceMinor: z.ZodNumber;
+}, z.core.$strip>;
+export type PostPurchaseDisplayPrice = z.infer<typeof PostPurchaseDisplayPrice>;

package/dist/schema/postPurchaseFollowups.d.ts

@@ -125,6 +125,53 @@ export declare const AcceptedFollowupsResponseSchema: z.ZodObject<{
             recordedAt: z.ZodNumber;
             operationId: z.ZodUUID;
         }, z.core.$strict>;
+        upgrade: z.ZodOptional<z.ZodObject<{
+            compensation: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+                attemptedAt: z.ZodNumber;
+                status: z.ZodLiteral<"attempted">;
+            }, z.core.$strict>, z.ZodObject<{
+                attemptedAt: z.ZodNumber;
+                finishedAt: z.ZodNumber;
+                status: z.ZodEnum<{
+                    unknown: "unknown";
+                    failed: "failed";
+                    removed: "removed";
+                }>;
+            }, z.core.$strict>]>>;
+            operationId: z.ZodUUID;
+            refund: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+                attemptedAt: z.ZodNumber;
+                status: z.ZodLiteral<"attempted">;
+            }, z.core.$strict>, z.ZodObject<{
+                attemptedAt: z.ZodNumber;
+                finishedAt: z.ZodNumber;
+                refundId: z.ZodString;
+                status: z.ZodLiteral<"refunded">;
+            }, z.core.$strict>, z.ZodObject<{
+                attemptedAt: z.ZodNumber;
+                finishedAt: z.ZodNumber;
+                status: z.ZodEnum<{
+                    unknown: "unknown";
+                    failed: "failed";
+                }>;
+            }, z.core.$strict>]>>;
+            review: z.ZodNullable<z.ZodObject<{
+                markedAt: z.ZodNumber;
+                marker: z.ZodUnion<readonly [z.ZodEnum<{
+                    unknown: "unknown";
+                    acknowledged: "acknowledged";
+                    rejected: "rejected";
+                }>, z.ZodEnum<{
+                    attempted: "attempted";
+                    unavailable: "unavailable";
+                }>]>;
+                reason: z.ZodEnum<{
+                    "refund-unknown": "refund-unknown";
+                    "compensation-failed": "compensation-failed";
+                    "compensation-unknown": "compensation-unknown";
+                }>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
     }, z.core.$strip>;
     successful: z.ZodLiteral<true>;
 }, z.core.$strip>;

package/dist/schema/postPurchaseHealth.d.ts

@@ -15,6 +15,7 @@ export declare const HealthAttemptSchema: z.ZodObject<{
     removePartialOrder: z.ZodBoolean;
     operationId: z.ZodUUID;
     healthScheduledAt: z.ZodNumber;
+    checkoutToken: z.ZodOptional<z.ZodString>;
     scheduleReceipt: z.ZodOptional<z.ZodObject<{
         recordedAt: z.ZodNumber;
         taskName: z.ZodString;
@@ -28,6 +29,7 @@ export declare const HealthResultSchema: z.ZodObject<{
     removePartialOrder: z.ZodBoolean;
     operationId: z.ZodUUID;
     healthScheduledAt: z.ZodNumber;
+    checkoutToken: z.ZodOptional<z.ZodString>;
     scheduleReceipt: z.ZodOptional<z.ZodObject<{
         recordedAt: z.ZodNumber;
         taskName: z.ZodString;
@@ -45,6 +47,7 @@ export declare const HealthStateSchema: z.ZodUnion<readonly [z.ZodObject<{
     removePartialOrder: z.ZodBoolean;
     operationId: z.ZodUUID;
     healthScheduledAt: z.ZodNumber;
+    checkoutToken: z.ZodOptional<z.ZodString>;
     scheduleReceipt: z.ZodOptional<z.ZodObject<{
         recordedAt: z.ZodNumber;
         taskName: z.ZodString;
@@ -54,6 +57,7 @@ export declare const HealthStateSchema: z.ZodUnion<readonly [z.ZodObject<{
     removePartialOrder: z.ZodBoolean;
     operationId: z.ZodUUID;
     healthScheduledAt: z.ZodNumber;
+    checkoutToken: z.ZodOptional<z.ZodString>;
     scheduleReceipt: z.ZodOptional<z.ZodObject<{
         recordedAt: z.ZodNumber;
         taskName: z.ZodString;
@@ -65,6 +69,7 @@ export declare const HealthStateSchema: z.ZodUnion<readonly [z.ZodObject<{
     removePartialOrder: z.ZodBoolean;
     operationId: z.ZodUUID;
     healthScheduledAt: z.ZodNumber;
+    checkoutToken: z.ZodOptional<z.ZodString>;
     scheduleReceipt: z.ZodOptional<z.ZodObject<{
         recordedAt: z.ZodNumber;
         taskName: z.ZodString;

package/dist/schema/postPurchasePlanCatalog.d.ts

@@ -13,6 +13,7 @@ export declare const PostPurchasePlanOption: z.ZodObject<{
             percentage: "percentage";
         }>;
     }, z.core.$strip>>;
+    discountPercentage: z.ZodOptional<z.ZodNumber>;
     id: z.ZodNumber;
     intervalFrequency: z.ZodOptional<z.ZodString>;
     intervalLabel: z.ZodString;
@@ -30,6 +31,7 @@ export declare const PostPurchasePlanCatalog: z.ZodObject<{
                 percentage: "percentage";
             }>;
         }, z.core.$strip>>;
+        discountPercentage: z.ZodOptional<z.ZodNumber>;
         id: z.ZodNumber;
         intervalFrequency: z.ZodOptional<z.ZodString>;
         intervalLabel: z.ZodString;

package/dist/schema/postPurchaseProduct.d.ts

@@ -100,6 +100,7 @@ export declare const PreparedPostPurchaseProduct: z.ZodObject<{
     labels: z.ZodObject<{
         declineAll: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         free: z.ZodString;
+        notAvailable: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         payNow: z.ZodString;
         quantity: z.ZodString;
         recurringShipping: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -263,6 +264,7 @@ export declare const PostPurchasePreparation: z.ZodDiscriminatedUnion<[z.ZodObje
     labels: z.ZodObject<{
         declineAll: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         free: z.ZodString;
+        notAvailable: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         payNow: z.ZodString;
         quantity: z.ZodString;
         recurringShipping: z.ZodDefault<z.ZodOptional<z.ZodString>>;

package/dist/schema/postPurchaseProductCollectionView.d.ts

@@ -5,6 +5,62 @@ export declare const PostPurchaseProductCollectionView: z.ZodObject<{
         productId: z.ZodNumber;
         productIndex: z.ZodNumber;
         view: z.ZodUnion<readonly [z.ZodObject<{
+            changeset: z.ZodOptional<z.ZodObject<{
+                changes: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                    discount: z.ZodOptional<z.ZodObject<{
+                        title: z.ZodString;
+                        value: z.ZodNumber;
+                        valueType: z.ZodEnum<{
+                            fixed_amount: "fixed_amount";
+                            percentage: "percentage";
+                        }>;
+                    }, z.core.$strip>>;
+                    quantity: z.ZodNumber;
+                    type: z.ZodLiteral<"add_variant">;
+                    variantId: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    price: z.ZodNumber;
+                    title: z.ZodString;
+                    type: z.ZodLiteral<"add_shipping_line">;
+                }, z.core.$strip>, z.ZodObject<{
+                    initialShippingPrice: z.ZodNumber;
+                    recurringShippingPrice: z.ZodNumber;
+                    shippingOption: z.ZodObject<{
+                        presentmentTitle: z.ZodString;
+                        title: z.ZodString;
+                    }, z.core.$strip>;
+                    discount: z.ZodOptional<z.ZodObject<{
+                        title: z.ZodString;
+                        value: z.ZodNumber;
+                        valueType: z.ZodEnum<{
+                            fixed_amount: "fixed_amount";
+                            percentage: "percentage";
+                        }>;
+                    }, z.core.$strip>>;
+                    quantity: z.ZodNumber;
+                    sellingPlanId: z.ZodNumber;
+                    type: z.ZodLiteral<"add_subscription">;
+                    variantId: z.ZodNumber;
+                }, z.core.$strip>]>>;
+            }, z.core.$strip>>;
+            displayPrice: z.ZodOptional<z.ZodObject<{
+                currencyCode: z.ZodString;
+                savingFormat: z.ZodEnum<{
+                    amount: "amount";
+                    percent: "percent";
+                }>;
+                savingMinor: z.ZodNumber;
+                savingPercent: z.ZodNumber;
+                subscriptionUnit: z.ZodOptional<z.ZodObject<{
+                    comparisonMinor: z.ZodNumber;
+                    currencyCode: z.ZodString;
+                    priceMinor: z.ZodNumber;
+                    savingMinor: z.ZodNumber;
+                    savingPercent: z.ZodNumber;
+                }, z.core.$strip>>;
+                variantCompareAtPriceMinor: z.ZodNullable<z.ZodNumber>;
+                variantPriceMinor: z.ZodNumber;
+            }, z.core.$strip>>;
             groupCatalog: z.ZodOptional<z.ZodObject<{
                 memberProductId: z.ZodNumber;
                 options: z.ZodArray<z.ZodObject<{
@@ -48,6 +104,7 @@ export declare const PostPurchaseProductCollectionView: z.ZodObject<{
                             percentage: "percentage";
                         }>;
                     }, z.core.$strip>>;
+                    discountPercentage: z.ZodOptional<z.ZodNumber>;
                     id: z.ZodNumber;
                     intervalFrequency: z.ZodOptional<z.ZodString>;
                     intervalLabel: z.ZodString;
@@ -61,6 +118,7 @@ export declare const PostPurchaseProductCollectionView: z.ZodObject<{
                 labels: z.ZodObject<{
                     declineAll: z.ZodDefault<z.ZodOptional<z.ZodString>>;
                     free: z.ZodString;
+                    notAvailable: z.ZodDefault<z.ZodOptional<z.ZodString>>;
                     payNow: z.ZodString;
                     quantity: z.ZodString;
                     recurringShipping: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -656,6 +714,9 @@ export declare const PostPurchaseProductCollectionView: z.ZodObject<{
             initialVariant: z.ZodOptional<z.ZodObject<{
                 variantId: z.ZodNumber;
             }, z.core.$strict>>;
+            labels: z.ZodOptional<z.ZodObject<{
+                notAvailable: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
             planCatalog: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                 plans: z.ZodArray<z.ZodObject<{
                     adjustment: z.ZodOptional<z.ZodObject<{
@@ -666,6 +727,7 @@ export declare const PostPurchaseProductCollectionView: z.ZodObject<{
                             percentage: "percentage";
                         }>;
                     }, z.core.$strip>>;
+                    discountPercentage: z.ZodOptional<z.ZodNumber>;
                     id: z.ZodNumber;
                     intervalFrequency: z.ZodOptional<z.ZodString>;
                     intervalLabel: z.ZodString;

package/dist/schema/postPurchaseProductView.d.ts

@@ -2,8 +2,67 @@ import { z } from 'zod';
 /**
  * A prepared view shows exactly one description: plain `description`, or — when the merchant's rich
  * description wins the precedence — `description: null` with the standard-shape `descriptionDocument`.
+ * Only a prepared view may carry `changeset`: the unsigned changeset the server derived from this very
+ * preparation (the one admission later rebuilds and signs), ready for Shopify's `calculateChangeset`, and
+ * `displayPrice`: the display pricing worked out from that same preparation.
  */
 export declare const PostPurchaseProductView: z.ZodUnion<readonly [z.ZodObject<{
+    changeset: z.ZodOptional<z.ZodObject<{
+        changes: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            discount: z.ZodOptional<z.ZodObject<{
+                title: z.ZodString;
+                value: z.ZodNumber;
+                valueType: z.ZodEnum<{
+                    fixed_amount: "fixed_amount";
+                    percentage: "percentage";
+                }>;
+            }, z.core.$strip>>;
+            quantity: z.ZodNumber;
+            type: z.ZodLiteral<"add_variant">;
+            variantId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            price: z.ZodNumber;
+            title: z.ZodString;
+            type: z.ZodLiteral<"add_shipping_line">;
+        }, z.core.$strip>, z.ZodObject<{
+            initialShippingPrice: z.ZodNumber;
+            recurringShippingPrice: z.ZodNumber;
+            shippingOption: z.ZodObject<{
+                presentmentTitle: z.ZodString;
+                title: z.ZodString;
+            }, z.core.$strip>;
+            discount: z.ZodOptional<z.ZodObject<{
+                title: z.ZodString;
+                value: z.ZodNumber;
+                valueType: z.ZodEnum<{
+                    fixed_amount: "fixed_amount";
+                    percentage: "percentage";
+                }>;
+            }, z.core.$strip>>;
+            quantity: z.ZodNumber;
+            sellingPlanId: z.ZodNumber;
+            type: z.ZodLiteral<"add_subscription">;
+            variantId: z.ZodNumber;
+        }, z.core.$strip>]>>;
+    }, z.core.$strip>>;
+    displayPrice: z.ZodOptional<z.ZodObject<{
+        currencyCode: z.ZodString;
+        savingFormat: z.ZodEnum<{
+            amount: "amount";
+            percent: "percent";
+        }>;
+        savingMinor: z.ZodNumber;
+        savingPercent: z.ZodNumber;
+        subscriptionUnit: z.ZodOptional<z.ZodObject<{
+            comparisonMinor: z.ZodNumber;
+            currencyCode: z.ZodString;
+            priceMinor: z.ZodNumber;
+            savingMinor: z.ZodNumber;
+            savingPercent: z.ZodNumber;
+        }, z.core.$strip>>;
+        variantCompareAtPriceMinor: z.ZodNullable<z.ZodNumber>;
+        variantPriceMinor: z.ZodNumber;
+    }, z.core.$strip>>;
     groupCatalog: z.ZodOptional<z.ZodObject<{
         memberProductId: z.ZodNumber;
         options: z.ZodArray<z.ZodObject<{
@@ -47,6 +106,7 @@ export declare const PostPurchaseProductView: z.ZodUnion<readonly [z.ZodObject<{
                     percentage: "percentage";
                 }>;
             }, z.core.$strip>>;
+            discountPercentage: z.ZodOptional<z.ZodNumber>;
             id: z.ZodNumber;
             intervalFrequency: z.ZodOptional<z.ZodString>;
             intervalLabel: z.ZodString;
@@ -60,6 +120,7 @@ export declare const PostPurchaseProductView: z.ZodUnion<readonly [z.ZodObject<{
         labels: z.ZodObject<{
             declineAll: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             free: z.ZodString;
+            notAvailable: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             payNow: z.ZodString;
             quantity: z.ZodString;
             recurringShipping: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -655,6 +716,9 @@ export declare const PostPurchaseProductView: z.ZodUnion<readonly [z.ZodObject<{
     initialVariant: z.ZodOptional<z.ZodObject<{
         variantId: z.ZodNumber;
     }, z.core.$strict>>;
+    labels: z.ZodOptional<z.ZodObject<{
+        notAvailable: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>;
     planCatalog: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         plans: z.ZodArray<z.ZodObject<{
             adjustment: z.ZodOptional<z.ZodObject<{
@@ -665,6 +729,7 @@ export declare const PostPurchaseProductView: z.ZodUnion<readonly [z.ZodObject<{
                     percentage: "percentage";
                 }>;
             }, z.core.$strip>>;
+            discountPercentage: z.ZodOptional<z.ZodNumber>;
             id: z.ZodNumber;
             intervalFrequency: z.ZodOptional<z.ZodString>;
             intervalLabel: z.ZodString;

package/dist/schema/postPurchaseRecovery.d.ts

@@ -39,6 +39,53 @@ export declare const PurchaseRecoveryResponseSchema: z.ZodObject<{
                 recordedAt: z.ZodNumber;
             }, z.core.$strict>>;
             operationId: z.ZodUUID;
+            upgrade: z.ZodOptional<z.ZodObject<{
+                compensation: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+                    attemptedAt: z.ZodNumber;
+                    status: z.ZodLiteral<"attempted">;
+                }, z.core.$strict>, z.ZodObject<{
+                    attemptedAt: z.ZodNumber;
+                    finishedAt: z.ZodNumber;
+                    status: z.ZodEnum<{
+                        unknown: "unknown";
+                        failed: "failed";
+                        removed: "removed";
+                    }>;
+                }, z.core.$strict>]>>;
+                operationId: z.ZodUUID;
+                refund: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+                    attemptedAt: z.ZodNumber;
+                    status: z.ZodLiteral<"attempted">;
+                }, z.core.$strict>, z.ZodObject<{
+                    attemptedAt: z.ZodNumber;
+                    finishedAt: z.ZodNumber;
+                    refundId: z.ZodString;
+                    status: z.ZodLiteral<"refunded">;
+                }, z.core.$strict>, z.ZodObject<{
+                    attemptedAt: z.ZodNumber;
+                    finishedAt: z.ZodNumber;
+                    status: z.ZodEnum<{
+                        unknown: "unknown";
+                        failed: "failed";
+                    }>;
+                }, z.core.$strict>]>>;
+                review: z.ZodNullable<z.ZodObject<{
+                    markedAt: z.ZodNumber;
+                    marker: z.ZodUnion<readonly [z.ZodEnum<{
+                        unknown: "unknown";
+                        acknowledged: "acknowledged";
+                        rejected: "rejected";
+                    }>, z.ZodEnum<{
+                        attempted: "attempted";
+                        unavailable: "unavailable";
+                    }>]>;
+                    reason: z.ZodEnum<{
+                        "refund-unknown": "refund-unknown";
+                        "compensation-failed": "compensation-failed";
+                        "compensation-unknown": "compensation-unknown";
+                    }>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
         }, z.core.$strict>>;
         progress: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             closedAt: z.ZodNullable<z.ZodNumber>;

package/dist/schema/postPurchaseSubscriptionProduct.d.ts

@@ -93,6 +93,7 @@ export declare const PreparedPostPurchaseSubscription: z.ZodObject<{
     labels: z.ZodObject<{
         declineAll: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         free: z.ZodString;
+        notAvailable: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         payNow: z.ZodString;
         quantity: z.ZodString;
         recurringShipping: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -245,6 +246,7 @@ export declare const readPostPurchaseSubscription: (prepared: z.infer<typeof Pre
     labels: {
         declineAll: string;
         free: string;
+        notAvailable: string;
         payNow: string;
         quantity: string;
         recurringShipping: string;

package/dist/schema/postPurchaseUpgrade.d.ts

@@ -0,0 +1,117 @@
+import { z } from 'zod';
+/**
+ * apiv2 `refund-product` for the upgrade's original one-time line. `failed` is a known refusal (nothing was
+ * refunded); `unknown` is a lost or ambiguous answer, which is never retried and never compensated blindly.
+ */
+export declare const UpgradeRefundProgressSchema: z.ZodUnion<readonly [z.ZodObject<{
+    attemptedAt: z.ZodNumber;
+    status: z.ZodLiteral<"attempted">;
+}, z.core.$strict>, z.ZodObject<{
+    attemptedAt: z.ZodNumber;
+    finishedAt: z.ZodNumber;
+    refundId: z.ZodString;
+    status: z.ZodLiteral<"refunded">;
+}, z.core.$strict>, z.ZodObject<{
+    attemptedAt: z.ZodNumber;
+    finishedAt: z.ZodNumber;
+    status: z.ZodEnum<{
+        unknown: "unknown";
+        failed: "failed";
+    }>;
+}, z.core.$strict>]>;
+/** apiv2 `remove-subscription-product`: the rollback that runs only after a known refund failure. */
+export declare const UpgradeCompensationProgressSchema: z.ZodUnion<readonly [z.ZodObject<{
+    attemptedAt: z.ZodNumber;
+    status: z.ZodLiteral<"attempted">;
+}, z.core.$strict>, z.ZodObject<{
+    attemptedAt: z.ZodNumber;
+    finishedAt: z.ZodNumber;
+    status: z.ZodEnum<{
+        unknown: "unknown";
+        failed: "failed";
+        removed: "removed";
+    }>;
+}, z.core.$strict>]>;
+/**
+ * Why the upgrade is left for a person; `marker` is the `subscription_rollback_failed` metafield write. A
+ * `marker` of `unavailable` means the marker could not be written, NOT that no review is needed: the review
+ * stands whatever the marker status.
+ */
+export declare const UpgradeReviewReasonSchema: z.ZodEnum<{
+    "refund-unknown": "refund-unknown";
+    "compensation-failed": "compensation-failed";
+    "compensation-unknown": "compensation-unknown";
+}>;
+export declare const UpgradeReviewProgressSchema: z.ZodObject<{
+    markedAt: z.ZodNumber;
+    marker: z.ZodUnion<readonly [z.ZodEnum<{
+        unknown: "unknown";
+        acknowledged: "acknowledged";
+        rejected: "rejected";
+    }>, z.ZodEnum<{
+        attempted: "attempted";
+        unavailable: "unavailable";
+    }>]>;
+    reason: z.ZodEnum<{
+        "refund-unknown": "refund-unknown";
+        "compensation-failed": "compensation-failed";
+        "compensation-unknown": "compensation-unknown";
+    }>;
+}, z.core.$strict>;
+/**
+ * The refund-compensation saga of one admitted upgrade, `null` steps not yet started. Compensation follows a
+ * known refund failure only, and a review is recorded exactly when the outcome is unresolved (an unknown
+ * refund, or a failed or unknown rollback), so a compensated or unresolved upgrade never reads as upgraded.
+ */
+export declare const UpgradeProgressSchema: z.ZodObject<{
+    compensation: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+        attemptedAt: z.ZodNumber;
+        status: z.ZodLiteral<"attempted">;
+    }, z.core.$strict>, z.ZodObject<{
+        attemptedAt: z.ZodNumber;
+        finishedAt: z.ZodNumber;
+        status: z.ZodEnum<{
+            unknown: "unknown";
+            failed: "failed";
+            removed: "removed";
+        }>;
+    }, z.core.$strict>]>>;
+    operationId: z.ZodUUID;
+    refund: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+        attemptedAt: z.ZodNumber;
+        status: z.ZodLiteral<"attempted">;
+    }, z.core.$strict>, z.ZodObject<{
+        attemptedAt: z.ZodNumber;
+        finishedAt: z.ZodNumber;
+        refundId: z.ZodString;
+        status: z.ZodLiteral<"refunded">;
+    }, z.core.$strict>, z.ZodObject<{
+        attemptedAt: z.ZodNumber;
+        finishedAt: z.ZodNumber;
+        status: z.ZodEnum<{
+            unknown: "unknown";
+            failed: "failed";
+        }>;
+    }, z.core.$strict>]>>;
+    review: z.ZodNullable<z.ZodObject<{
+        markedAt: z.ZodNumber;
+        marker: z.ZodUnion<readonly [z.ZodEnum<{
+            unknown: "unknown";
+            acknowledged: "acknowledged";
+            rejected: "rejected";
+        }>, z.ZodEnum<{
+            attempted: "attempted";
+            unavailable: "unavailable";
+        }>]>;
+        reason: z.ZodEnum<{
+            "refund-unknown": "refund-unknown";
+            "compensation-failed": "compensation-failed";
+            "compensation-unknown": "compensation-unknown";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type UpgradeCompensationProgress = z.infer<typeof UpgradeCompensationProgressSchema>;
+export type UpgradeProgress = z.infer<typeof UpgradeProgressSchema>;
+export type UpgradeRefundProgress = z.infer<typeof UpgradeRefundProgressSchema>;
+export type UpgradeReviewProgress = z.infer<typeof UpgradeReviewProgressSchema>;
+export type UpgradeReviewReason = z.infer<typeof UpgradeReviewReasonSchema>;