@nok-integration/storefront-react 0.20.17 → 0.21.1

package/dist/index.d.ts

@@ -23,15 +23,15 @@ declare type AddCartItemRequest = z.infer<typeof AddCartItemRequest>;
 
 /** The `error` member — a machine `code`, a human `message`, and optional `details`. */
 declare const ApiErrorBody: z.ZodObject<{
-    code: z.ZodEnum<["invalid_request", "unauthorized", "out_of_stock", "cart_locked", "sku_not_found", "category_not_found", "amount_mismatch", "duplicate_order", "order_not_found", "order_not_cancellable", "cart_not_found", "support_ticket_not_found", "size_chart_not_found", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
+    code: z.ZodEnum<["invalid_request", "unauthorized", "out_of_stock", "cart_locked", "sku_not_found", "category_not_found", "amount_mismatch", "duplicate_order", "order_not_found", "order_not_cancellable", "cart_not_found", "support_ticket_not_found", "vip_invite_not_found", "vip_cart_conflict", "vip_invite_mismatch", "size_chart_not_found", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
     message: z.ZodString;
     details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    code: "invalid_request" | "unauthorized" | "out_of_stock" | "cart_locked" | "sku_not_found" | "category_not_found" | "amount_mismatch" | "duplicate_order" | "order_not_found" | "order_not_cancellable" | "cart_not_found" | "support_ticket_not_found" | "size_chart_not_found" | "forbidden" | "invalid_transition" | "rate_limited" | "server_error";
+    code: "invalid_request" | "unauthorized" | "out_of_stock" | "cart_locked" | "sku_not_found" | "category_not_found" | "amount_mismatch" | "duplicate_order" | "order_not_found" | "order_not_cancellable" | "cart_not_found" | "support_ticket_not_found" | "vip_invite_not_found" | "vip_cart_conflict" | "vip_invite_mismatch" | "size_chart_not_found" | "forbidden" | "invalid_transition" | "rate_limited" | "server_error";
     message: string;
     details?: Record<string, unknown> | undefined;
 }, {
-    code: "invalid_request" | "unauthorized" | "out_of_stock" | "cart_locked" | "sku_not_found" | "category_not_found" | "amount_mismatch" | "duplicate_order" | "order_not_found" | "order_not_cancellable" | "cart_not_found" | "support_ticket_not_found" | "size_chart_not_found" | "forbidden" | "invalid_transition" | "rate_limited" | "server_error";
+    code: "invalid_request" | "unauthorized" | "out_of_stock" | "cart_locked" | "sku_not_found" | "category_not_found" | "amount_mismatch" | "duplicate_order" | "order_not_found" | "order_not_cancellable" | "cart_not_found" | "support_ticket_not_found" | "vip_invite_not_found" | "vip_cart_conflict" | "vip_invite_mismatch" | "size_chart_not_found" | "forbidden" | "invalid_transition" | "rate_limited" | "server_error";
     message: string;
     details?: Record<string, unknown> | undefined;
 }>;
@@ -194,12 +194,12 @@ declare const CartItem: z.ZodObject<{
         amount: number;
         currency: string;
     };
+    image?: string | undefined;
     compare_at_unit_price?: {
         amount: number;
         currency: string;
     } | undefined;
     title?: string | undefined;
-    image?: string | undefined;
     attributes?: Record<string, string> | undefined;
     available?: number | undefined;
 }, {
@@ -213,12 +213,12 @@ declare const CartItem: z.ZodObject<{
         amount: number;
         currency: string;
     };
+    image?: string | undefined;
     compare_at_unit_price?: {
         amount: number;
         currency: string;
     } | undefined;
     title?: string | undefined;
-    image?: string | undefined;
     attributes?: Record<string, string> | undefined;
     available?: number | undefined;
 }>;
@@ -1621,25 +1621,25 @@ declare const CategoryPage: z.ZodObject<{
             title: z.ZodString;
             body: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            title: string;
             body: string;
+            title: string;
             icon?: "payment" | "delivery" | "returns" | undefined;
         }, {
-            title: string;
             body: string;
+            title: string;
             icon?: "payment" | "delivery" | "returns" | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         items: {
-            title: string;
             body: string;
+            title: string;
             icon?: "payment" | "delivery" | "returns" | undefined;
         }[];
         kind: "why_us";
     }, {
         items: {
-            title: string;
             body: string;
+            title: string;
             icon?: "payment" | "delivery" | "returns" | undefined;
         }[];
         kind: "why_us";
@@ -1830,8 +1830,8 @@ declare const CategoryPage: z.ZodObject<{
         disclaimer?: string | undefined;
     } | {
         items: {
-            title: string;
             body: string;
+            title: string;
             icon?: "payment" | "delivery" | "returns" | undefined;
         }[];
         kind: "why_us";
@@ -2047,8 +2047,8 @@ declare const CategoryPage: z.ZodObject<{
         disclaimer?: string | undefined;
     } | {
         items: {
-            title: string;
             body: string;
+            title: string;
             icon?: "payment" | "delivery" | "returns" | undefined;
         }[];
         kind: "why_us";
@@ -2684,8 +2684,8 @@ declare function createClient(options: ClientOptions): {
                 } | undefined;
             };
             locked?: {
-                since: string;
                 reason: "checkout_handoff";
+                since: string;
                 expires_at?: string | undefined;
             } | undefined;
             hold?: {
@@ -2693,6 +2693,9 @@ declare function createClient(options: ClientOptions): {
                 taken_at: string;
             } | undefined;
             hidden_lines?: ("shipping" | "tax")[] | undefined;
+            vip?: {
+                invite_ref: string;
+            } | undefined;
         }>;
         get: (query?: CartMarketQuery) => Promise<{
             currency: string;
@@ -2740,8 +2743,8 @@ declare function createClient(options: ClientOptions): {
                 } | undefined;
             };
             locked?: {
-                since: string;
                 reason: "checkout_handoff";
+                since: string;
                 expires_at?: string | undefined;
             } | undefined;
             hold?: {
@@ -2749,6 +2752,9 @@ declare function createClient(options: ClientOptions): {
                 taken_at: string;
             } | undefined;
             hidden_lines?: ("shipping" | "tax")[] | undefined;
+            vip?: {
+                invite_ref: string;
+            } | undefined;
         }>;
         addItem: (body: AddCartItemRequest, query?: CartMarketQuery) => Promise<{
             currency: string;
@@ -2796,8 +2802,8 @@ declare function createClient(options: ClientOptions): {
                 } | undefined;
             };
             locked?: {
-                since: string;
                 reason: "checkout_handoff";
+                since: string;
                 expires_at?: string | undefined;
             } | undefined;
             hold?: {
@@ -2805,6 +2811,9 @@ declare function createClient(options: ClientOptions): {
                 taken_at: string;
             } | undefined;
             hidden_lines?: ("shipping" | "tax")[] | undefined;
+            vip?: {
+                invite_ref: string;
+            } | undefined;
         }>;
         updateItem: (sku: string, body: UpdateCartItemRequest, query?: CartMarketQuery) => Promise<{
             currency: string;
@@ -2852,8 +2861,8 @@ declare function createClient(options: ClientOptions): {
                 } | undefined;
             };
             locked?: {
-                since: string;
                 reason: "checkout_handoff";
+                since: string;
                 expires_at?: string | undefined;
             } | undefined;
             hold?: {
@@ -2861,6 +2870,9 @@ declare function createClient(options: ClientOptions): {
                 taken_at: string;
             } | undefined;
             hidden_lines?: ("shipping" | "tax")[] | undefined;
+            vip?: {
+                invite_ref: string;
+            } | undefined;
         }>;
         removeItem: (sku: string, query?: CartMarketQuery) => Promise<{
             currency: string;
@@ -2908,8 +2920,8 @@ declare function createClient(options: ClientOptions): {
                 } | undefined;
             };
             locked?: {
-                since: string;
                 reason: "checkout_handoff";
+                since: string;
                 expires_at?: string | undefined;
             } | undefined;
             hold?: {
@@ -2917,6 +2929,9 @@ declare function createClient(options: ClientOptions): {
                 taken_at: string;
             } | undefined;
             hidden_lines?: ("shipping" | "tax")[] | undefined;
+            vip?: {
+                invite_ref: string;
+            } | undefined;
         }>;
         /**
          * Hand the cart to DAZN checkout and get the URL to send the fan to.
@@ -2949,9 +2964,9 @@ declare function createClient(options: ClientOptions): {
                     amount: number;
                     currency: string;
                 };
+                headline: string;
                 order_ref: string;
                 placed_at: string;
-                headline: string;
                 item_count: number;
                 image?: string | undefined;
                 images?: string[] | undefined;
@@ -2964,8 +2979,8 @@ declare function createClient(options: ClientOptions): {
                 };
                 status: "reported" | "package_received" | "completed";
                 currency: string;
-                order_ref: string;
                 headline: string;
+                order_ref: string;
                 item_count: number;
                 return_ref: string;
                 reported_at: string;
@@ -2998,6 +3013,7 @@ declare function createClient(options: ClientOptions): {
                 } | undefined;
                 returned_qty?: number | undefined;
             }[];
+            headline: string;
             totals: {
                 shipping: {
                     amount: number;
@@ -3031,7 +3047,6 @@ declare function createClient(options: ClientOptions): {
                 line2?: string | undefined;
                 region?: string | undefined;
             };
-            headline: string;
             progress: {
                 label: string;
                 step: "packing" | "on_its_way" | "out_for_delivery" | "delivered" | "cancelled";
@@ -3048,6 +3063,9 @@ declare function createClient(options: ClientOptions): {
                 return_ref: string;
                 reported_at: string;
             }[] | undefined;
+            vip?: {
+                invite_ref: string;
+            } | undefined;
             estimated_delivery?: {
                 from: string;
                 to: string;
@@ -3092,6 +3110,7 @@ declare function createClient(options: ClientOptions): {
                 } | undefined;
                 returned_qty?: number | undefined;
             }[];
+            headline: string;
             totals: {
                 shipping: {
                     amount: number;
@@ -3125,7 +3144,6 @@ declare function createClient(options: ClientOptions): {
                 line2?: string | undefined;
                 region?: string | undefined;
             };
-            headline: string;
             progress: {
                 label: string;
                 step: "packing" | "on_its_way" | "out_for_delivery" | "delivered" | "cancelled";
@@ -3142,6 +3160,9 @@ declare function createClient(options: ClientOptions): {
                 return_ref: string;
                 reported_at: string;
             }[] | undefined;
+            vip?: {
+                invite_ref: string;
+            } | undefined;
             estimated_delivery?: {
                 from: string;
                 to: string;
@@ -3160,11 +3181,11 @@ declare function createClient(options: ClientOptions): {
             items: {
                 sku: string;
                 qty: number;
+                reason: "too_small" | "changed_my_mind" | "too_large" | "arrived_too_late" | "item_damaged" | "not_as_described";
                 unit_price: {
                     amount: number;
                     currency: string;
                 };
-                reason: "too_small" | "changed_my_mind" | "too_large" | "arrived_too_late" | "item_damaged" | "not_as_described";
                 line_ref: string;
                 attributes?: Record<string, string> | undefined;
                 image?: string | undefined;
@@ -3193,11 +3214,11 @@ declare function createClient(options: ClientOptions): {
             items: {
                 sku: string;
                 qty: number;
+                reason: "too_small" | "changed_my_mind" | "too_large" | "arrived_too_late" | "item_damaged" | "not_as_described";
                 unit_price: {
                     amount: number;
                     currency: string;
                 };
-                reason: "too_small" | "changed_my_mind" | "too_large" | "arrived_too_late" | "item_damaged" | "not_as_described";
                 line_ref: string;
                 attributes?: Record<string, string> | undefined;
                 image?: string | undefined;
@@ -3244,6 +3265,94 @@ declare function createClient(options: ClientOptions): {
             created_at: string;
         }>;
     };
+    vip: {
+        resolve: (token: string, query?: CartMarketQuery) => Promise<{
+            items: {
+                product_sku: string;
+                quantity: number;
+            }[];
+            state: "active";
+            invite_ref: string;
+            recipient_name: string;
+            personal_message: string | null;
+            delivery_rule: "both_free" | "standard_free" | "both_paid";
+            expires_at: string;
+            hero?: {
+                image: string | null;
+                body: string | null;
+                headline: string;
+                cta_label: string;
+            } | null | undefined;
+        } | {
+            state: "scheduled";
+            opens_at: string;
+        } | {
+            state: "claimed";
+        } | {
+            state: "expired";
+        } | {
+            state: "revoked";
+        }>;
+        addToCart: (body: VipCartItemRequest, query?: CartMarketQuery) => Promise<{
+            currency: string;
+            items: {
+                sku: string;
+                qty: number;
+                unit_price: {
+                    amount: number;
+                    currency: string;
+                };
+                line_total: {
+                    amount: number;
+                    currency: string;
+                };
+                attributes?: Record<string, string> | undefined;
+                image?: string | undefined;
+                available?: number | undefined;
+                title?: string | undefined;
+                compare_at_unit_price?: {
+                    amount: number;
+                    currency: string;
+                } | undefined;
+            }[];
+            cart_id: string;
+            totals: {
+                subtotal: {
+                    amount: number;
+                    currency: string;
+                };
+                shipping: {
+                    amount: number;
+                    currency: string;
+                };
+                tax: {
+                    amount: number;
+                    currency: string;
+                };
+                total: {
+                    amount: number;
+                    currency: string;
+                };
+                discount?: {
+                    amount: number;
+                    currency: string;
+                } | undefined;
+            };
+            locked?: {
+                reason: "checkout_handoff";
+                since: string;
+                expires_at?: string | undefined;
+            } | undefined;
+            hold?: {
+                expires_at: string;
+                taken_at: string;
+            } | undefined;
+            hidden_lines?: ("shipping" | "tax")[] | undefined;
+            vip?: {
+                invite_ref: string;
+            } | undefined;
+        }>;
+    };
     auth: {
         /** Exchange a single-use DAZN identity JWT for a session (sets the cookie). */
         exchangeSession: (body: SessionExchangeRequest) => Promise<{
@@ -3449,7 +3558,7 @@ export declare interface EmptyStateProps {
  * | rate_limited       | 429  | too many requests                             |
  * | server_error       | 500  | unexpected error (safe to retry idempotent)   |
  */
-declare const ErrorCode: z.ZodEnum<["invalid_request", "unauthorized", "out_of_stock", "cart_locked", "sku_not_found", "category_not_found", "amount_mismatch", "duplicate_order", "order_not_found", "order_not_cancellable", "cart_not_found", "support_ticket_not_found", "size_chart_not_found", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
+declare const ErrorCode: z.ZodEnum<["invalid_request", "unauthorized", "out_of_stock", "cart_locked", "sku_not_found", "category_not_found", "amount_mismatch", "duplicate_order", "order_not_found", "order_not_cancellable", "cart_not_found", "support_ticket_not_found", "vip_invite_not_found", "vip_cart_conflict", "vip_invite_mismatch", "size_chart_not_found", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
 
 declare type ErrorCode = z.infer<typeof ErrorCode>;
 
@@ -3472,7 +3581,7 @@ declare type ErrorCode = z.infer<typeof ErrorCode>;
  * | rate_limited       | 429  | too many requests                             |
  * | server_error       | 500  | unexpected error (safe to retry idempotent)   |
  */
-declare const ErrorCode_2: z.ZodEnum<["invalid_request", "unauthorized", "out_of_stock", "cart_locked", "sku_not_found", "category_not_found", "amount_mismatch", "duplicate_order", "order_not_found", "order_not_cancellable", "cart_not_found", "support_ticket_not_found", "size_chart_not_found", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
+declare const ErrorCode_2: z.ZodEnum<["invalid_request", "unauthorized", "out_of_stock", "cart_locked", "sku_not_found", "category_not_found", "amount_mismatch", "duplicate_order", "order_not_found", "order_not_cancellable", "cart_not_found", "support_ticket_not_found", "vip_invite_not_found", "vip_cart_conflict", "vip_invite_mismatch", "size_chart_not_found", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
 
 declare type ErrorCode_2 = z.infer<typeof ErrorCode_2>;
 
@@ -3963,12 +4072,12 @@ declare const OrderDetail: z.ZodObject<{
         line_ref: string;
         cancelled_qty: number;
         refunded_qty: number;
+        image?: string | undefined;
         compare_at_unit_price?: {
             amount: number;
             currency: string;
         } | undefined;
         title?: string | undefined;
-        image?: string | undefined;
         attributes?: Record<string, string> | undefined;
         returned_qty?: number | undefined;
     }, {
@@ -3985,12 +4094,12 @@ declare const OrderDetail: z.ZodObject<{
         line_ref: string;
         cancelled_qty: number;
         refunded_qty: number;
+        image?: string | undefined;
         compare_at_unit_price?: {
             amount: number;
             currency: string;
         } | undefined;
         title?: string | undefined;
-        image?: string | undefined;
         attributes?: Record<string, string> | undefined;
         returned_qty?: number | undefined;
     }>, "many">;
@@ -4149,9 +4258,18 @@ declare const OrderDetail: z.ZodObject<{
         return_ref: string;
         reported_at: string;
     }>, "many">>;
+    /** Present when the order was claimed under a VIP invite. It cannot be ordered again. */
+    vip: z.ZodOptional<z.ZodObject<{
+        invite_ref: z.ZodBranded<z.ZodString, "VipInviteRef">;
+    }, "strip", z.ZodTypeAny, {
+        invite_ref: string & z.BRAND<"VipInviteRef">;
+    }, {
+        invite_ref: string;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     status: "packing" | "on_its_way" | "out_for_delivery" | "delivered" | "cancelled";
     currency: string;
+    headline: string;
     items: {
         sku: string;
         qty: number;
@@ -4166,12 +4284,12 @@ declare const OrderDetail: z.ZodObject<{
         line_ref: string;
         cancelled_qty: number;
         refunded_qty: number;
+        image?: string | undefined;
         compare_at_unit_price?: {
             amount: number;
             currency: string;
         } | undefined;
         title?: string | undefined;
-        image?: string | undefined;
         attributes?: Record<string, string> | undefined;
         returned_qty?: number | undefined;
     }[];
@@ -4208,7 +4326,6 @@ declare const OrderDetail: z.ZodObject<{
         line2?: string | undefined;
         region?: string | undefined;
     };
-    headline: string;
     progress: {
         label: string;
         step: "packing" | "on_its_way" | "out_for_delivery" | "delivered" | "cancelled";
@@ -4216,6 +4333,9 @@ declare const OrderDetail: z.ZodObject<{
         at?: string | undefined;
     }[];
     email?: string | undefined;
+    vip?: {
+        invite_ref: string & z.BRAND<"VipInviteRef">;
+    } | undefined;
     payment?: {
         brand: string;
         last4?: string | undefined;
@@ -4239,6 +4359,7 @@ declare const OrderDetail: z.ZodObject<{
 }, {
     status: "packing" | "on_its_way" | "out_for_delivery" | "delivered" | "cancelled";
     currency: string;
+    headline: string;
     items: {
         sku: string;
         qty: number;
@@ -4253,12 +4374,12 @@ declare const OrderDetail: z.ZodObject<{
         line_ref: string;
         cancelled_qty: number;
         refunded_qty: number;
+        image?: string | undefined;
         compare_at_unit_price?: {
             amount: number;
             currency: string;
         } | undefined;
         title?: string | undefined;
-        image?: string | undefined;
         attributes?: Record<string, string> | undefined;
         returned_qty?: number | undefined;
     }[];
@@ -4295,7 +4416,6 @@ declare const OrderDetail: z.ZodObject<{
         line2?: string | undefined;
         region?: string | undefined;
     };
-    headline: string;
     progress: {
         label: string;
         step: "packing" | "on_its_way" | "out_for_delivery" | "delivered" | "cancelled";
@@ -4303,6 +4423,9 @@ declare const OrderDetail: z.ZodObject<{
         at?: string | undefined;
     }[];
     email?: string | undefined;
+    vip?: {
+        invite_ref: string;
+    } | undefined;
     payment?: {
         brand: string;
         last4?: string | undefined;
@@ -4955,13 +5078,18 @@ declare class ProductCache {
  * the size error). Add-to-cart calls the engine through the session so a 401 silently
  * re-handshakes.
  */
-export declare function ProductDetail({ product, inventory, recommendations }: ProductDetailProps): JSX.Element;
+export declare function ProductDetail({ product, inventory, recommendations, claim, }: ProductDetailProps): JSX.Element;
 
 export declare interface ProductDetailProps {
     product: Product;
     inventory: Inventory | null;
     /** "You may also like" rail — related products from the engine. Empty = rail hidden. */
     recommendations?: Product[];
+    /**
+     * Turns the page into a VIP invite's product: free, its regular price struck through, and
+     * "Claim yours" in place of add-to-cart. Called with the chosen variant's SKU.
+     */
+    claim?: (sku: string) => Promise<void>;
 }
 
 /**
@@ -5358,34 +5486,34 @@ declare const ReturnDetail: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         sku: string;
         qty: number;
+        reason: "too_small" | "changed_my_mind" | "too_large" | "arrived_too_late" | "item_damaged" | "not_as_described";
         unit_price: {
             amount: number;
             currency: string;
         };
-        reason: "too_small" | "changed_my_mind" | "too_large" | "arrived_too_late" | "item_damaged" | "not_as_described";
         line_ref: string;
+        image?: string | undefined;
         compare_at_unit_price?: {
             amount: number;
             currency: string;
         } | undefined;
         title?: string | undefined;
-        image?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }, {
         sku: string;
         qty: number;
+        reason: "too_small" | "changed_my_mind" | "too_large" | "arrived_too_late" | "item_damaged" | "not_as_described";
         unit_price: {
             amount: number;
             currency: string;
         };
-        reason: "too_small" | "changed_my_mind" | "too_large" | "arrived_too_late" | "item_damaged" | "not_as_described";
         line_ref: string;
+        image?: string | undefined;
         compare_at_unit_price?: {
             amount: number;
             currency: string;
         } | undefined;
         title?: string | undefined;
-        image?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }>, "many">;
     label_url: z.ZodOptional<z.ZodString>;
@@ -5399,18 +5527,18 @@ declare const ReturnDetail: z.ZodObject<{
     items: {
         sku: string;
         qty: number;
+        reason: "too_small" | "changed_my_mind" | "too_large" | "arrived_too_late" | "item_damaged" | "not_as_described";
         unit_price: {
             amount: number;
             currency: string;
         };
-        reason: "too_small" | "changed_my_mind" | "too_large" | "arrived_too_late" | "item_damaged" | "not_as_described";
         line_ref: string;
+        image?: string | undefined;
         compare_at_unit_price?: {
             amount: number;
             currency: string;
         } | undefined;
         title?: string | undefined;
-        image?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }[];
     order_ref: string & z.BRAND<"OrderRef">;
@@ -5429,18 +5557,18 @@ declare const ReturnDetail: z.ZodObject<{
     items: {
         sku: string;
         qty: number;
+        reason: "too_small" | "changed_my_mind" | "too_large" | "arrived_too_late" | "item_damaged" | "not_as_described";
         unit_price: {
             amount: number;
             currency: string;
         };
-        reason: "too_small" | "changed_my_mind" | "too_large" | "arrived_too_late" | "item_damaged" | "not_as_described";
         line_ref: string;
+        image?: string | undefined;
         compare_at_unit_price?: {
             amount: number;
             currency: string;
         } | undefined;
         title?: string | undefined;
-        image?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }[];
     order_ref: string;
@@ -6427,14 +6555,14 @@ declare const SupportTicketRequest: z.ZodObject<{
     email: string;
     description: string;
     category: string;
-    image_url?: string | undefined;
     dazn_user_id?: string | undefined;
+    image_url?: string | undefined;
 }, {
     email: string;
     description: string;
     category: string;
-    image_url?: string | undefined;
     dazn_user_id?: string | undefined;
+    image_url?: string | undefined;
 }>;
 
 declare type SupportTicketRequest = z.infer<typeof SupportTicketRequest>;
@@ -6687,6 +6815,157 @@ export declare interface VariantSelectorProps {
     labelAttribute?: string;
 }
 
+declare const VipCartItemRequest: z.ZodObject<{
+    token: z.ZodString;
+    sku: z.ZodString;
+    qty: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    sku: string;
+    token: string;
+    qty: number;
+}, {
+    sku: string;
+    token: string;
+    qty: number;
+}>;
+
+declare type VipCartItemRequest = z.infer<typeof VipCartItemRequest>;
+
+export declare function VipHero({ hero, onContinue }: VipHeroProps): JSX.Element;
+
+declare const VipHero_2: z.ZodObject<{
+    image: z.ZodNullable<z.ZodString>;
+    headline: z.ZodString;
+    body: z.ZodNullable<z.ZodString>;
+    cta_label: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    image: string | null;
+    headline: string;
+    body: string | null;
+    cta_label: string;
+}, {
+    image: string | null;
+    headline: string;
+    body: string | null;
+    cta_label: string;
+}>;
+
+declare type VipHero_2 = z.infer<typeof VipHero_2>;
+
+export declare interface VipHeroProps {
+    hero: VipHero_2;
+    onContinue: () => void;
+}
+
+export declare type VipInviteUnavailableState = Exclude<VipInviteView['state'], 'active'>;
+
+declare const VipInviteView: z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
+    state: z.ZodLiteral<"active">;
+    invite_ref: z.ZodBranded<z.ZodString, "VipInviteRef">;
+    recipient_name: z.ZodString;
+    personal_message: z.ZodNullable<z.ZodString>;
+    delivery_rule: z.ZodEnum<["both_free", "standard_free", "both_paid"]>;
+    expires_at: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        product_sku: z.ZodString;
+        quantity: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        product_sku: string;
+        quantity: number;
+    }, {
+        product_sku: string;
+        quantity: number;
+    }>, "many">;
+    hero: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        image: z.ZodNullable<z.ZodString>;
+        headline: z.ZodString;
+        body: z.ZodNullable<z.ZodString>;
+        cta_label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        image: string | null;
+        headline: string;
+        body: string | null;
+        cta_label: string;
+    }, {
+        image: string | null;
+        headline: string;
+        body: string | null;
+        cta_label: string;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    state: "active";
+    invite_ref: string & z.BRAND<"VipInviteRef">;
+    recipient_name: string;
+    personal_message: string | null;
+    delivery_rule: "both_free" | "standard_free" | "both_paid";
+    expires_at: string;
+    items: {
+        product_sku: string;
+        quantity: number;
+    }[];
+    hero?: {
+        image: string | null;
+        headline: string;
+        body: string | null;
+        cta_label: string;
+    } | null | undefined;
+}, {
+    state: "active";
+    invite_ref: string;
+    recipient_name: string;
+    personal_message: string | null;
+    delivery_rule: "both_free" | "standard_free" | "both_paid";
+    expires_at: string;
+    items: {
+        product_sku: string;
+        quantity: number;
+    }[];
+    hero?: {
+        image: string | null;
+        headline: string;
+        body: string | null;
+        cta_label: string;
+    } | null | undefined;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"scheduled">;
+    opens_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    state: "scheduled";
+    opens_at: string;
+}, {
+    state: "scheduled";
+    opens_at: string;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"claimed">;
+}, "strip", z.ZodTypeAny, {
+    state: "claimed";
+}, {
+    state: "claimed";
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"expired">;
+}, "strip", z.ZodTypeAny, {
+    state: "expired";
+}, {
+    state: "expired";
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"revoked">;
+}, "strip", z.ZodTypeAny, {
+    state: "revoked";
+}, {
+    state: "revoked";
+}>]>;
+
+declare type VipInviteView = z.infer<typeof VipInviteView>;
+
+export declare function VipLandingView({ token, onUnavailable }: VipLandingViewProps): JSX.Element;
+
+export declare interface VipLandingViewProps {
+    /** The token from the invite link: the last path segment of the URL the recipient opened. */
+    token: string;
+    /** Replaces the built-in screen for an invite that cannot be claimed. */
+    onUnavailable?: (state: VipInviteUnavailableState) => ReactNode;
+}
+
 /** "Why shop with us" reassurance tiles. */
 export declare function WhyUs({ items }: {
     items: WhyUsItem[];