@nok-integration/storefront-react 0.16.5 → 0.17.0

package/dist/index.d.ts

@@ -24,15 +24,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", "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", "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" | "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" | "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" | "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" | "forbidden" | "invalid_transition" | "rate_limited" | "server_error";
     message: string;
     details?: Record<string, unknown> | undefined;
 }>;
@@ -252,6 +252,11 @@ export { CartSheetProvider }
 /**
  * Opens the cart as a bottom sheet.
  *
+ * Carries `data-shop-cart-trigger` in both forms. That is what the added-to-cart toast
+ * aims its caret at (Figma `.base/indicator`), and it has to survive the anchor/button
+ * split — the arrow points at the cart control, not at whichever element we happened to
+ * render it as.
+ *
  * Falls back to a link to `/cart` when no {@link CartSheetProvider} is above it, so the
  * cart is always reachable — including with JS unavailable, where the anchor still
  * navigates. The route renders the same CartView, so the fallback is the same cart, not
@@ -2067,6 +2072,10 @@ declare function createClient(options: ClientOptions): {
                 attributes?: Record<string, string> | undefined;
                 image?: string | undefined;
                 title?: string | undefined;
+                compare_at_unit_price?: {
+                    amount: number;
+                    currency: string;
+                } | undefined;
             }[];
             totals: {
                 shipping: {
@@ -2085,6 +2094,10 @@ declare function createClient(options: ClientOptions): {
                     amount: number;
                     currency: string;
                 };
+                discount?: {
+                    amount: number;
+                    currency: string;
+                } | undefined;
             };
             order_ref: string;
             placed_at: string;
@@ -2104,6 +2117,7 @@ declare function createClient(options: ClientOptions): {
                 current: boolean;
                 at?: string | undefined;
             }[];
+            email?: string | undefined;
             payment?: {
                 brand: string;
                 last4?: string | undefined;
@@ -2119,6 +2133,30 @@ declare function createClient(options: ClientOptions): {
             } | undefined;
         }>;
     };
+    /**
+     * The Help Center form (ADR-0021). Session-scoped: the ticket is filed against the
+     * fan already signed in, and there is no parameter that names a different one.
+     */
+    support: {
+        /**
+         * Upload the one attachment and get the URL to put on the ticket.
+         *
+         * Call this first, then pass the returned `url` as `image_url`. Uploading nothing is
+         * the normal case — the field is optional and the form's Send button does not wait
+         * on it.
+         */
+        uploadAttachment: (file: Blob) => Promise<{
+            url: string;
+            content_type: string;
+            bytes: number;
+        }>;
+        /** File the ticket. Repeating an identical one within a few minutes returns the first. */
+        createTicket: (body: SupportTicketRequest) => Promise<{
+            category: string;
+            reference: string;
+            created_at: string;
+        }>;
+    };
     auth: {
         /** Exchange a single-use DAZN identity JWT for a session (sets the cookie). */
         exchangeSession: (body: SessionExchangeRequest) => Promise<{
@@ -2284,7 +2322,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", "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", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
 
 declare type ErrorCode = z.infer<typeof ErrorCode>;
 
@@ -2307,7 +2345,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", "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", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
 
 declare type ErrorCode_2 = z.infer<typeof ErrorCode_2>;
 
@@ -2530,6 +2568,37 @@ export declare type Navigate = (to: ShopRoute) => void;
  */
 export declare type OnEvent = (event: ShopEvent) => void;
 
+/**
+ * The order confirmation (Figma `5295:74053`).
+ *
+ * **A different screen from `OrderTrackingView`, not a state of it**, which is the answer
+ * to the question DAZN asked on 20 Aug 2026. The two frames differ in their chrome
+ * (close-only against back + cart + overflow), in their headline, and in their footer
+ * action, and nothing in the payload can tell them apart: `status` is a fulfilment step
+ * and cannot say "has just come back from paying", and time-since-placed guesses wrong for
+ * anyone who opens the email an hour later. So the two screens are two routes, and the one
+ * that navigates here is the one that knows — the checkout that has just finished.
+ *
+ * Read-only, like tracking. The frame's footer is "Done" rather than "Cancel order"
+ * precisely because cancellation is DAZN's under ADR-0008 and ADR-0017.
+ */
+export declare function OrderConfirmationView(props: OrderConfirmationViewProps): JSX.Element;
+
+export declare interface OrderConfirmationViewProps {
+    /** DAZN's order reference, e.g. `ord_GB26081021` or `787293`. */
+    orderRef: string;
+    /** Overrides the provider's locale for dates. */
+    locale?: string;
+    /**
+     * The frame's "Done". Omit it and no button renders.
+     *
+     * Where it goes is the host's: in the embed this is the end of a checkout DAZN own, so
+     * only they know whether it closes the webview, returns to the shop, or goes somewhere
+     * else entirely.
+     */
+    onDone?: () => void;
+}
+
 /**
  * The fan's orders (Figma `mobile/order/list`, ADR-0015).
  *
@@ -2615,7 +2684,7 @@ export declare interface OrderStatusBadgeProps {
  * The pricing breakdown. DISPLAY ONLY — every value is server-authoritative; the UI
  * never sums or computes anything here.
  */
-export declare function OrderSummary({ pricing, deferred, hidden, rows, }: OrderSummaryProps): JSX.Element;
+export declare function OrderSummary({ pricing, deferred, hidden, rows, discount, }: OrderSummaryProps): JSX.Element;
 
 export declare interface OrderSummaryProps {
     pricing: Pricing;
@@ -2652,6 +2721,15 @@ export declare interface OrderSummaryProps {
      * this that zeroed the value would turn a CMS switch into a pricing change.
      */
     hidden?: DeferredLine[];
+    /**
+     * What came off, as a positive amount (contracts 2.34.0 `OrderTotals.discount`). Drawn
+     * in the success tone with the minus sign written here.
+     *
+     * The sign belongs to the surface rather than the wire, so nothing downstream can add
+     * this to a running total: every figure in this component is server-authoritative and
+     * the grand total is DAZN's, never the sum of the rows above it.
+     */
+    discount?: Money;
 }
 
 /**
@@ -2997,7 +3075,7 @@ export declare function ProductDetail({ product, inventory, recommendations }: P
 export declare interface ProductDetailProps {
     product: Product;
     inventory: Inventory | null;
-    /** "You may like it" rail — related products from the engine. Empty = rail hidden. */
+    /** "You may also like" rail — related products from the engine. Empty = rail hidden. */
     recommendations?: Product[];
 }
 
@@ -3288,7 +3366,16 @@ declare type SessionExchangeRequest = z.infer<typeof SessionExchangeRequest>;
 /**
  * PDP shipping & returns block (mobile/pdp/shipping-info). Static informational copy —
  * no free-shipping threshold (per design). The shopper picks the delivery tier at
- * DAZN's checkout; this only signals that the options exist. Returns window is fixed.
+ * DAZN's checkout; this only signals that the options exist.
+ *
+ * **The returns window is 14 days, and it used to be 30.** ADR-0016 kept 30 because the
+ * design contradicted itself: this card said 14 on the PDP and 30 where the very same
+ * component was placed in the cart, so ours was the number the file agreed with more
+ * often. The current cart frame (5304:78218) says 14 as well, so the contradiction is
+ * gone and 14 is what the design now says in both places.
+ *
+ * It is still not OUR number. Returns are DAZN's under ADR-0008 and this only reports
+ * the policy — if 14 is wrong, it is wrong in the design and one word fixes it here.
  */
 export declare function ShippingInfo(): JSX.Element;
 
@@ -3376,7 +3463,7 @@ export declare type ShopEvent = {
 };
 
 /**
- * The 56px shop header from Figma `mobile/header` (context=shop): back chevron on the
+ * The 64px shop header from Figma `mobile/header` (context=shop): back chevron on the
  * left, cart and overflow on the right.
  *
  * **Optional, and off by default in every view.** In the real embed the DAZN app provides
@@ -3404,7 +3491,7 @@ export declare type ShopEvent = {
  * Mount it inside `DaznShopProvider`, and inside `CartSheet` if `showCart` is on, since
  * the trigger opens that sheet.
  */
-export declare function ShopHeader({ onBack, onMenu, showCart, floating, backLabel, menuLabel, className, }: ShopHeaderProps): JSX.Element;
+export declare function ShopHeader(props: ShopHeaderProps): JSX.Element;
 
 export declare interface ShopHeaderProps {
     /**
@@ -3414,6 +3501,14 @@ export declare interface ShopHeaderProps {
     onBack?: () => void;
     /** Overflow menu. Omitted by default: a control that opens nothing is worse than none. */
     onMenu?: () => void;
+    /**
+     * The screen name, drawn between the back control and the icons (Figma `mobile/header`
+     * carries "DAZN Shop" here on the shop entry).
+     *
+     * Optional, and the slot collapses without it rather than reserving space — the PDP
+     * frames leave it empty, so a bar with nothing in the middle is a state the design has.
+     */
+    title?: string;
     /** The cart icon and its live count. */
     showCart?: boolean;
     /**
@@ -3424,9 +3519,31 @@ export declare interface ShopHeaderProps {
      * block, and the content beneath must expect nothing reserved for the bar.
      */
     floating?: boolean;
+    /**
+     * Force the overlaid bar's scrim on or off instead of letting it follow the scroll.
+     *
+     * Only meaningful with `floating`. A host that scrolls something we cannot observe —
+     * a virtualised list, a native scroll view driving the webview — can drive it directly.
+     */
+    scrolled?: boolean;
+    /**
+     * Which of the bar's two contexts to draw. `mobile/header` declares both.
+     *
+     * - `shop` (default): back, title, cart, overflow. Every browsing screen.
+     * - `checkout`: **close only**, with the title on the screen's centre line and no cart.
+     *   The design's reasoning is that a fan inside a completed flow has one way out of it,
+     *   and a cart icon there invites them back into shopping from a receipt.
+     *
+     * `checkout` never reads the cart, so mounting it after an order does not fire a cart
+     * fetch for a badge that is not drawn.
+     */
+    context?: 'shop' | 'checkout';
+    /** The close control, in `checkout` context. Omit it and the slot stays reserved. */
+    onClose?: () => void;
     /** Accessible name for the back control, for a host that is not in English. */
     backLabel?: string;
     menuLabel?: string;
+    closeLabel?: string;
     className?: string;
 }
 
@@ -3494,20 +3611,25 @@ export declare interface ShopLinkProps extends Omit<AnchorHTMLAttributes<HTMLAnc
 }
 
 /**
- * The header's overflow menu (Figma `Settings`, 636:51006).
+ * The header's overflow menu (Figma `menu-open`, 4613:58644).
+ *
+ * A light card anchored under the bar, over a scrim, with a close control and two rows.
  *
- * A light card anchored under the bar, over a scrim, with a close control and three rows.
+ * **"Redeem a code" is gone**, and the design is what removed it. The menu had three rows
+ * from `Settings` (636:51006) on the page ADR-0022 retired; the frame of record draws
+ * exactly two, orders and help. It is the one row this package rendered knowing it could
+ * never work — promotions are DAZN's and nothing in the commerce API can redeem anything —
+ * so a fan tapping it got a control that did nothing, every time, by design. Both sides
+ * now agree it should not be there.
  *
- * **A row with no handler renders and does nothing.** That is a deliberate exception to
- * the rule this package follows everywhere else — `ShopHeader` omits its own menu button
- * unless a host supplies `onMenu`, precisely because a control that opens nothing is worse
- * than none. It is made here on instruction, so the menu matches the design in full while
- * two of its three destinations do not yet exist on either side: code redemption has no
- * mechanism in the commerce API at all, and help belongs to DAZN. An inert row is still
- * marked `aria-disabled`, so a screen reader is told what a sighted fan discovers by
- * tapping, rather than announcing a link to nowhere as though it worked.
+ * **A row with no handler still renders and does nothing.** That is a deliberate exception
+ * to the rule this package follows everywhere else — `ShopHeader` omits its own menu
+ * button unless a host supplies `onMenu`, precisely because a control that opens nothing
+ * is worse than none. It survives for help, which is DAZN's own surface and exists; a host
+ * that has one passes `onHelp`. An inert row is marked `aria-disabled`, so a screen reader
+ * is told what a sighted fan discovers by tapping.
  */
-export declare function ShopMenuSheet({ open, onClose, onManageOrders, onRedeemCode, onHelp, closeLabel, label, }: ShopMenuSheetProps): JSX.Element | null;
+export declare function ShopMenuSheet({ open, onClose, onManageOrders, onHelp, closeLabel, label, }: ShopMenuSheetProps): JSX.Element | null;
 
 export declare interface ShopMenuSheetProps {
     open: boolean;
@@ -3517,11 +3639,6 @@ export declare interface ShopMenuSheetProps {
      * `OrderListView`.
      */
     onManageOrders?: () => void;
-    /**
-     * Code redemption. **Nothing in the commerce API can redeem a code** — promotions are
-     * DAZN's, and the row is inert until they give us somewhere to send it.
-     */
-    onRedeemCode?: () => void;
     /** Help. DAZN's own surface, so a host that has one passes it here. */
     onHelp?: () => void;
     closeLabel?: string;
@@ -3759,9 +3876,54 @@ declare type StockAlertRequest = z.infer<typeof StockAlertRequest>;
 
 declare interface SummaryRow {
     label: string;
-    key: keyof Pricing;
+    /**
+     * A figure from `pricing`, or `discount` — the one row whose value does not live there.
+     *
+     * `Pricing` is the cart's shape and has no discount in it, and adding one would change a
+     * published schema for a row only the order screens draw. It comes in on its own prop
+     * instead, and a row asking for it when nothing was discounted is simply not drawn.
+     */
+    key: keyof Pricing | 'discount';
 }
 
+/** `POST /v1/support/tickets` — the Help Center form, submitted. */
+declare const SupportTicketRequest: z.ZodObject<{
+    /**
+     * Where the fan wants the reply. Pre-filled from the account in the design, and
+     * editable — so this is a contact address, not proof of identity.
+     */
+    email: z.ZodString;
+    category: z.ZodString;
+    /**
+     * The fan's own words. Bounded at 4000 characters because an unbounded text column
+     * reachable from the open internet is a storage-exhaustion vector, not because CS
+     * asked for a limit — they have not, and this is the one number here we chose. It is
+     * roughly two pages, and it is configuration away from being different.
+     */
+    description: z.ZodString;
+    /**
+     * One attachment, as a URL — the shape CS specified.
+     *
+     * The URL is not free-form: it must be one the engine issued from
+     * `POST /v1/support/attachments`. A ticket carrying an arbitrary address would have a
+     * CS agent's browser fetch whatever a stranger typed, from inside DAZN's network, on
+     * a page showing another customer's data.
+     */
+    image_url: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    email: string;
+    category: string;
+    description: string;
+    image_url?: string | undefined;
+}, {
+    email: string;
+    category: string;
+    description: string;
+    image_url?: string | undefined;
+}>;
+
+declare type SupportTicketRequest = z.infer<typeof SupportTicketRequest>;
+
 export declare function swatchColour(name: string): string;
 
 /** An optional inline action, e.g. the undo offered after removing a cart line. */
@@ -3786,6 +3948,15 @@ declare interface ToastOptions {
     description?: string;
     /** 40×40 thumbnail. Decorative, so never given alt text. */
     image?: string;
+    /**
+     * Draw the caret pointing at the cart icon in the header (Figma `.base/indicator`).
+     *
+     * Opt-in rather than implied by `description`/`image`, because the caret is an
+     * assertion about where the thing went. "We'll let you know" after a stock-alert
+     * request is the same shaped card and did NOT go into anybody's cart; pointing it at
+     * the cart badge would be a small lie told in the most literal way available.
+     */
+    anchor?: 'cart';
 }
 
 export declare function ToastProvider({ children }: {