@clickaroo/checkout-ui 0.1.3-beta → 0.1.5-beta

package/dist/storybook/storybook-static/assets/CheckoutPage.en-C5I1UUQc.js

@@ -0,0 +1,147 @@
+import{j as e}from"./jsx-runtime-DiklIkkE.js";import{useMDXComponents as c}from"./index-ChEI-nsM.js";import{M as s,C as o,a as d}from"./index-LRKEu_dQ.js";import{C as l,D as r}from"./CheckoutPage.stories-DLD3oWo_.js";import"./index-DRjF_FHU.js";import"./iframe-Ce3kgeV4.js";import"./index-B7ki2Uzk.js";import"./index-D-Mha1DF.js";import"./index-DrFu-skq.js";import"./useCheckoutContext-B8tsk5b5.js";import"./CheckoutPage-BsnzMxJk.js";import"./CustomerInfo-CTx1dFS3.js";import"./ValidateInput-Cl2O4HCX.js";import"./DeliveryAddress-X81XGbKD.js";import"./PaymentMethods-BNEEARzu.js";function i(t){const n={a:"a",code:"code",h1:"h1",h3:"h3",h4:"h4",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...c(),...t.components};return e.jsxs(e.Fragment,{children:[e.jsx(s,{of:l,title:"Documentation/Usage Guide/CheckoutPage",name:"CheckoutPage (English)"}),`
+`,e.jsx(n.h1,{id:"checkoutpage",children:"CheckoutPage"}),`
+`,e.jsx(n.p,{children:"A complete checkout page component that integrates customer information, delivery address, payment methods, and order submission functionality."}),`
+`,e.jsx(n.h3,{id:"basic-usage",children:"Basic Usage"}),`
+`,e.jsx(o,{of:r}),`
+`,e.jsx(n.h3,{id:"props",children:"Props"}),`
+`,e.jsx(d,{of:r}),`
+`,e.jsx(n.h4,{id:"cart",children:"cart"}),`
+`,e.jsx(n.p,{children:"Array of cart items. Each item represents a product in the checkout."}),`
+`,e.jsxs(n.p,{children:["Type: ",e.jsx(n.code,{children:"CartItem[]"}),". See ",e.jsx(n.a,{href:"#cartitem",children:"CartItem Type Definition"})," for details."]}),`
+`,e.jsx(n.p,{children:"Each cart item contains the following fields:"}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Required Fields:"})}),`
+`,e.jsxs("table",{children:[e.jsx("thead",{children:e.jsxs("tr",{children:[e.jsx("th",{children:"Field"}),e.jsx("th",{children:"Type"}),e.jsx("th",{children:"Required"}),e.jsx("th",{children:"Description"})]})}),e.jsxs("tbody",{children:[e.jsxs("tr",{children:[e.jsx("td",{children:e.jsx("code",{children:"sku"})}),e.jsx("td",{children:e.jsx("code",{children:"string"})}),e.jsx("td",{children:"✅"}),e.jsx("td",{children:"Product SKU"})]}),e.jsxs("tr",{children:[e.jsx("td",{children:e.jsx("code",{children:"offerPricePoint"})}),e.jsx("td",{children:e.jsx("code",{children:"string"})}),e.jsx("td",{children:"✅"}),e.jsx("td",{children:"Price Point ID"})]})]})]}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Optional Fields:"})}),`
+`,e.jsxs(n.p,{children:["In addition to the two required fields ",e.jsx(n.code,{children:"sku"})," and ",e.jsx(n.code,{children:"offerPricePoint"}),", you can pass any other fields to each cart item. These additional fields will be saved to the order's ",e.jsx(n.code,{children:"metadata"})," and can be accessed later when retrieving order details through the ",e.jsx(n.code,{children:"useOrderDetail"})," hook."]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`const cart = [
+  {
+    sku: "TEST001",
+    offerPricePoint: "OPP-TEST001",
+    // Any other fields are allowed
+    title: "Product Title",
+    price: 99.99,
+    image: "https://example.com/product.jpg",
+    category: "Electronics",
+    // ... more fields
+  }
+];
+
+const { orderDetail } = useOrderDetail(orderCode)
+console.log(orderDetail.metadata.products)
+/** [
+  {
+    sku: "TEST001",
+    offerPricePoint: "OPP-TEST001",
+    title: "Product Title",
+    price: 99.99,
+    image: "https://example.com/product.jpg",
+    category: "Electronics",
+  }
+]
+**/
+`})}),`
+`,e.jsx(n.h4,{id:"oncheckoutinit",children:"onCheckoutInit"}),`
+`,e.jsxs(n.p,{children:["Callback function when checkout initializes, triggered immediately after the ",e.jsx(n.code,{children:"CheckoutPage"})," component mounts, used to track the start of the checkout flow."]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onCheckoutInit?: () => void
+`})}),`
+`,e.jsx(n.h4,{id:"onpaymentinfocomplete",children:"onPaymentInfoComplete"}),`
+`,e.jsx(n.p,{children:"Callback function when payment information is complete, triggered when the user completes the payment form and payment element validation passes."}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onPaymentInfoComplete?: (products: CheckoutCartItem[], totalAmount: number) => void
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Parameter Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"products"})," - Cart items array, type ",e.jsx(n.code,{children:"CheckoutCartItem[]"}),". Returns an array of cart items. See ",e.jsx(n.a,{href:"#checkoutcartitem",children:"CheckoutCartItem Type Definition"})," for details"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"totalAmount"})," - Total payment amount in cents (e.g., 9999 represents $99.99). For multiple items, this is the sum of all items"]}),`
+`]}),`
+`,e.jsx(n.h4,{id:"onordersubmit",children:"onOrderSubmit"}),`
+`,e.jsx(n.p,{children:"Callback function when order is submitted, triggered after the user clicks the submit button and before order processing begins."}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onOrderSubmit?: (products: CheckoutCartItem[], totalAmount: number) => void
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Parameter Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"products"})," - Submitted cart items array, type ",e.jsx(n.code,{children:"CheckoutCartItem[]"}),". See ",e.jsx(n.a,{href:"#checkoutcartitem",children:"CheckoutCartItem Type Definition"})," for details"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"totalAmount"})," - Total amount at submission time in cents (e.g., 9999 represents $99.99)"]}),`
+`]}),`
+`,e.jsx(n.h4,{id:"onordersuccess",children:"onOrderSuccess"}),`
+`,e.jsx(n.p,{children:"Callback function when order succeeds, triggered after the order is successfully created."}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onOrderSuccess?: (orderCode: string, tradeCode?: string) => void
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Parameter Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"orderCode"})," - Order code"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"tradeCode"})," - Trade code (optional)"]}),`
+`]}),`
+`,e.jsx(n.h3,{id:"usage-examples",children:"Usage Examples"}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`import { CheckoutPage } from '@clickaroo/checkout-ui';
+
+function App() {
+  const cart = [
+    {
+      sku: "TEST001",
+      offerPricePoint: "OPP-TEST001",
+    }
+  ];
+
+  return (
+    <CheckoutPage 
+      cart={cart}
+      onCheckoutInit={() => {
+        console.log('Checkout initialized');
+      }}
+      onPaymentInfoComplete={(products, totalAmount) => {
+        console.log('Payment info complete');
+        console.log('Total amount:', totalAmount / 100);
+        products.forEach((product) => {
+          console.log('Product SKU:', product.sku);
+          console.log('Unit price:', product.priceInCents / 100, product.currency);
+          console.log('Quantity:', product.quantity);
+          console.log('Payment type:', product.paymentType);
+        });
+      }}
+      onOrderSubmit={(products, totalAmount) => {
+        console.log('Order submitted');
+        console.log('Total amount:', totalAmount / 100);
+      }}
+      onOrderSuccess={(orderCode, tradeCode) => {
+        console.log('Order successful', orderCode, tradeCode);
+      }}
+    />
+  );
+}
+`})}),`
+`,e.jsx(n.h3,{id:"key-types",children:"Key Types"}),`
+`,e.jsx(n.h4,{id:"cartitem",children:"CartItem"}),`
+`,e.jsxs(n.p,{children:[e.jsx(n.code,{children:"CartItem"})," is the basic cart item type passed to the ",e.jsx(n.code,{children:"CheckoutPage"})," component:"]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`interface CartItem {
+  // Required fields
+  sku: string;                    // Product SKU
+  offerPricePoint: string;        // Price Point ID
+  
+  // Optional fields - allows any custom fields, which will be saved to order metadata
+  [key: string]: unknown;
+}
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Field Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"sku"})," - Product SKU, required field"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"offerPricePoint"})," - Price Point ID, required field"]}),`
+`,e.jsxs(n.li,{children:["Other fields - You can pass any additional fields (such as ",e.jsx(n.code,{children:"title"}),", ",e.jsx(n.code,{children:"price"}),", ",e.jsx(n.code,{children:"image"}),", etc.), which will be saved to the order's ",e.jsx(n.code,{children:"metadata"})," and can be retrieved through ",e.jsx(n.code,{children:"useOrderDetail"})]}),`
+`]}),`
+`,e.jsx(n.h4,{id:"checkoutcartitem",children:"CheckoutCartItem"}),`
+`,e.jsxs(n.p,{children:[e.jsx(n.code,{children:"CheckoutCartItem"})," is the cart item type returned in callback functions, extending ",e.jsx(n.code,{children:"CartItem"})," and including price details:"]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`interface CheckoutCartItem extends CartItem {
+  // Inherits all fields from CartItem (sku, offerPricePoint, etc.)
+  priceInCents: number;           // Unit price in cents (e.g., 9999 represents $99.99)
+  currency: string;               // Currency type (e.g., "USD", "EUR")
+  quantity: number;               // Quantity
+  paymentType: "one-time" | "subscription";  // Payment type
+}
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Field Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:["Inherits all fields from ",e.jsx(n.code,{children:"CartItem"})," (such as ",e.jsx(n.code,{children:"sku"}),", ",e.jsx(n.code,{children:"offerPricePoint"}),", etc.)"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"priceInCents"})," - Unit price in cents"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"currency"})," - Currency type"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"quantity"})," - Quantity"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"paymentType"})," - Payment type: ",e.jsx(n.code,{children:'"one-time"'})," for one-time payment, ",e.jsx(n.code,{children:'"subscription"'})," for subscription payment"]}),`
+`]})]})}function T(t={}){const{wrapper:n}={...c(),...t.components};return n?e.jsx(n,{...t,children:e.jsx(i,{...t})}):i(t)}export{T as default};

package/dist/storybook/storybook-static/assets/CheckoutPage.en-CNVaEQvK.js

@@ -0,0 +1,147 @@
+import{j as e}from"./jsx-runtime-DiklIkkE.js";import{useMDXComponents as c}from"./index-ChEI-nsM.js";import{M as s,C as o,a as d}from"./index-DoDFfets.js";import{C as l,D as r}from"./CheckoutPage.stories-B8Vyz9GJ.js";import"./index-DRjF_FHU.js";import"./iframe-Crv4raYy.js";import"./index-B7ki2Uzk.js";import"./index-D-Mha1DF.js";import"./index-DrFu-skq.js";import"./useCheckoutContext-3YTrU8Qh.js";import"./CheckoutPage-DgZ1RopD.js";import"./CustomerInfo-mKAI6gWW.js";import"./ValidateInput-CXYuXafK.js";import"./DeliveryAddress-DaRy4l-D.js";import"./PaymentMethods-Buladk2O.js";function i(t){const n={a:"a",code:"code",h1:"h1",h3:"h3",h4:"h4",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...c(),...t.components};return e.jsxs(e.Fragment,{children:[e.jsx(s,{of:l,title:"Documentation/Usage Guide/CheckoutPage",name:"CheckoutPage (English)"}),`
+`,e.jsx(n.h1,{id:"checkoutpage",children:"CheckoutPage"}),`
+`,e.jsx(n.p,{children:"A complete checkout page component that integrates customer information, delivery address, payment methods, and order submission functionality."}),`
+`,e.jsx(n.h3,{id:"basic-usage",children:"Basic Usage"}),`
+`,e.jsx(o,{of:r}),`
+`,e.jsx(n.h3,{id:"props",children:"Props"}),`
+`,e.jsx(d,{of:r}),`
+`,e.jsx(n.h4,{id:"cart",children:"cart"}),`
+`,e.jsx(n.p,{children:"Array of cart items. Each item represents a product in the checkout."}),`
+`,e.jsxs(n.p,{children:["Type: ",e.jsx(n.code,{children:"CartItem[]"}),". See ",e.jsx(n.a,{href:"#cartitem",children:"CartItem Type Definition"})," for details."]}),`
+`,e.jsx(n.p,{children:"Each cart item contains the following fields:"}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Required Fields:"})}),`
+`,e.jsxs("table",{children:[e.jsx("thead",{children:e.jsxs("tr",{children:[e.jsx("th",{children:"Field"}),e.jsx("th",{children:"Type"}),e.jsx("th",{children:"Required"}),e.jsx("th",{children:"Description"})]})}),e.jsxs("tbody",{children:[e.jsxs("tr",{children:[e.jsx("td",{children:e.jsx("code",{children:"sku"})}),e.jsx("td",{children:e.jsx("code",{children:"string"})}),e.jsx("td",{children:"✅"}),e.jsx("td",{children:"Product SKU"})]}),e.jsxs("tr",{children:[e.jsx("td",{children:e.jsx("code",{children:"offerPricePoint"})}),e.jsx("td",{children:e.jsx("code",{children:"string"})}),e.jsx("td",{children:"✅"}),e.jsx("td",{children:"Price Point ID"})]})]})]}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Optional Fields:"})}),`
+`,e.jsxs(n.p,{children:["In addition to the two required fields ",e.jsx(n.code,{children:"sku"})," and ",e.jsx(n.code,{children:"offerPricePoint"}),", you can pass any other fields to each cart item. These additional fields will be saved to the order's ",e.jsx(n.code,{children:"metadata"})," and can be accessed later when retrieving order details through the ",e.jsx(n.code,{children:"useOrderDetail"})," hook."]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`const cart = [
+  {
+    sku: "TEST001",
+    offerPricePoint: "OPP-TEST001",
+    // Any other fields are allowed
+    title: "Product Title",
+    price: 99.99,
+    image: "https://example.com/product.jpg",
+    category: "Electronics",
+    // ... more fields
+  }
+];
+
+const { orderDetail } = useOrderDetail(orderCode)
+console.log(orderDetail.metadata.products)
+/** [
+  {
+    sku: "TEST001",
+    offerPricePoint: "OPP-TEST001",
+    title: "Product Title",
+    price: 99.99,
+    image: "https://example.com/product.jpg",
+    category: "Electronics",
+  }
+]
+**/
+`})}),`
+`,e.jsx(n.h4,{id:"oncheckoutinit",children:"onCheckoutInit"}),`
+`,e.jsxs(n.p,{children:["Callback function when checkout initializes, triggered immediately after the ",e.jsx(n.code,{children:"CheckoutPage"})," component mounts, used to track the start of the checkout flow."]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onCheckoutInit?: () => void
+`})}),`
+`,e.jsx(n.h4,{id:"onpaymentinfocomplete",children:"onPaymentInfoComplete"}),`
+`,e.jsx(n.p,{children:"Callback function when payment information is complete, triggered when the user completes the payment form and payment element validation passes."}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onPaymentInfoComplete?: (products: CheckoutCartItem[], totalAmount: number) => void
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Parameter Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"products"})," - Cart items array, type ",e.jsx(n.code,{children:"CheckoutCartItem[]"}),". Returns an array of cart items. See ",e.jsx(n.a,{href:"#checkoutcartitem",children:"CheckoutCartItem Type Definition"})," for details"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"totalAmount"})," - Total payment amount in cents (e.g., 9999 represents $99.99). For multiple items, this is the sum of all items"]}),`
+`]}),`
+`,e.jsx(n.h4,{id:"onordersubmit",children:"onOrderSubmit"}),`
+`,e.jsx(n.p,{children:"Callback function when order is submitted, triggered after the user clicks the submit button and before order processing begins."}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onOrderSubmit?: (products: CheckoutCartItem[], totalAmount: number) => void
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Parameter Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"products"})," - Submitted cart items array, type ",e.jsx(n.code,{children:"CheckoutCartItem[]"}),". See ",e.jsx(n.a,{href:"#checkoutcartitem",children:"CheckoutCartItem Type Definition"})," for details"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"totalAmount"})," - Total amount at submission time in cents (e.g., 9999 represents $99.99)"]}),`
+`]}),`
+`,e.jsx(n.h4,{id:"onordersuccess",children:"onOrderSuccess"}),`
+`,e.jsx(n.p,{children:"Callback function when order succeeds, triggered after the order is successfully created."}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onOrderSuccess?: (orderCode: string, tradeCode?: string) => void
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Parameter Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"orderCode"})," - Order code"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"tradeCode"})," - Trade code (optional)"]}),`
+`]}),`
+`,e.jsx(n.h3,{id:"usage-examples",children:"Usage Examples"}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`import { CheckoutPage } from '@clickaroo/checkout-ui';
+
+function App() {
+  const cart = [
+    {
+      sku: "TEST001",
+      offerPricePoint: "OPP-TEST001",
+    }
+  ];
+
+  return (
+    <CheckoutPage 
+      cart={cart}
+      onCheckoutInit={() => {
+        console.log('Checkout initialized');
+      }}
+      onPaymentInfoComplete={(products, totalAmount) => {
+        console.log('Payment info complete');
+        console.log('Total amount:', totalAmount / 100);
+        products.forEach((product) => {
+          console.log('Product SKU:', product.sku);
+          console.log('Unit price:', product.priceInCents / 100, product.currency);
+          console.log('Quantity:', product.quantity);
+          console.log('Payment type:', product.paymentType);
+        });
+      }}
+      onOrderSubmit={(products, totalAmount) => {
+        console.log('Order submitted');
+        console.log('Total amount:', totalAmount / 100);
+      }}
+      onOrderSuccess={(orderCode, tradeCode) => {
+        console.log('Order successful', orderCode, tradeCode);
+      }}
+    />
+  );
+}
+`})}),`
+`,e.jsx(n.h3,{id:"key-types",children:"Key Types"}),`
+`,e.jsx(n.h4,{id:"cartitem",children:"CartItem"}),`
+`,e.jsxs(n.p,{children:[e.jsx(n.code,{children:"CartItem"})," is the basic cart item type passed to the ",e.jsx(n.code,{children:"CheckoutPage"})," component:"]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`interface CartItem {
+  // Required fields
+  sku: string;                    // Product SKU
+  offerPricePoint: string;        // Price Point ID
+  
+  // Optional fields - allows any custom fields, which will be saved to order metadata
+  [key: string]: unknown;
+}
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Field Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"sku"})," - Product SKU, required field"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"offerPricePoint"})," - Price Point ID, required field"]}),`
+`,e.jsxs(n.li,{children:["Other fields - You can pass any additional fields (such as ",e.jsx(n.code,{children:"title"}),", ",e.jsx(n.code,{children:"price"}),", ",e.jsx(n.code,{children:"image"}),", etc.), which will be saved to the order's ",e.jsx(n.code,{children:"metadata"})," and can be retrieved through ",e.jsx(n.code,{children:"useOrderDetail"})]}),`
+`]}),`
+`,e.jsx(n.h4,{id:"checkoutcartitem",children:"CheckoutCartItem"}),`
+`,e.jsxs(n.p,{children:[e.jsx(n.code,{children:"CheckoutCartItem"})," is the cart item type returned in callback functions, extending ",e.jsx(n.code,{children:"CartItem"})," and including price details:"]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`interface CheckoutCartItem extends CartItem {
+  // Inherits all fields from CartItem (sku, offerPricePoint, etc.)
+  priceInCents: number;           // Unit price in cents (e.g., 9999 represents $99.99)
+  currency: string;               // Currency type (e.g., "USD", "EUR")
+  quantity: number;               // Quantity
+  paymentType: "one-time" | "subscription";  // Payment type
+}
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Field Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:["Inherits all fields from ",e.jsx(n.code,{children:"CartItem"})," (such as ",e.jsx(n.code,{children:"sku"}),", ",e.jsx(n.code,{children:"offerPricePoint"}),", etc.)"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"priceInCents"})," - Unit price in cents"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"currency"})," - Currency type"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"quantity"})," - Quantity"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"paymentType"})," - Payment type: ",e.jsx(n.code,{children:'"one-time"'})," for one-time payment, ",e.jsx(n.code,{children:'"subscription"'})," for subscription payment"]}),`
+`]})]})}function T(t={}){const{wrapper:n}={...c(),...t.components};return n?e.jsx(n,{...t,children:e.jsx(i,{...t})}):i(t)}export{T as default};

package/dist/storybook/storybook-static/assets/CheckoutPage.en-D87qzfwm.js

@@ -0,0 +1,147 @@
+import{j as e}from"./jsx-runtime-DiklIkkE.js";import{useMDXComponents as c}from"./index-ChEI-nsM.js";import{M as s,C as o,a as d}from"./index-3vMs57rT.js";import{C as l,D as r}from"./CheckoutPage.stories-BRP4VrvR.js";import"./index-DRjF_FHU.js";import"./iframe-DWFwLXCc.js";import"./index-B7ki2Uzk.js";import"./index-D-Mha1DF.js";import"./index-DrFu-skq.js";import"./useCheckoutContext-BW2h13W8.js";import"./CheckoutPage-DSLcTghb.js";import"./CustomerInfo-DShSrjMR.js";import"./ValidateInput-CECRKp4c.js";import"./DeliveryAddress-DY5lFnTv.js";import"./PaymentMethods-DmV3o0ow.js";function i(t){const n={a:"a",code:"code",h1:"h1",h3:"h3",h4:"h4",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...c(),...t.components};return e.jsxs(e.Fragment,{children:[e.jsx(s,{of:l,title:"Documentation/Usage Guide/CheckoutPage",name:"CheckoutPage (English)"}),`
+`,e.jsx(n.h1,{id:"checkoutpage",children:"CheckoutPage"}),`
+`,e.jsx(n.p,{children:"A complete checkout page component that integrates customer information, delivery address, payment methods, and order submission functionality."}),`
+`,e.jsx(n.h3,{id:"basic-usage",children:"Basic Usage"}),`
+`,e.jsx(o,{of:r}),`
+`,e.jsx(n.h3,{id:"props",children:"Props"}),`
+`,e.jsx(d,{of:r}),`
+`,e.jsx(n.h4,{id:"cart",children:"cart"}),`
+`,e.jsx(n.p,{children:"Array of cart items. Each item represents a product in the checkout."}),`
+`,e.jsxs(n.p,{children:["Type: ",e.jsx(n.code,{children:"CartItem[]"}),". See ",e.jsx(n.a,{href:"#cartitem",children:"CartItem Type Definition"})," for details."]}),`
+`,e.jsx(n.p,{children:"Each cart item contains the following fields:"}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Required Fields:"})}),`
+`,e.jsxs("table",{children:[e.jsx("thead",{children:e.jsxs("tr",{children:[e.jsx("th",{children:"Field"}),e.jsx("th",{children:"Type"}),e.jsx("th",{children:"Required"}),e.jsx("th",{children:"Description"})]})}),e.jsxs("tbody",{children:[e.jsxs("tr",{children:[e.jsx("td",{children:e.jsx("code",{children:"sku"})}),e.jsx("td",{children:e.jsx("code",{children:"string"})}),e.jsx("td",{children:"✅"}),e.jsx("td",{children:"Product SKU"})]}),e.jsxs("tr",{children:[e.jsx("td",{children:e.jsx("code",{children:"offerPricePoint"})}),e.jsx("td",{children:e.jsx("code",{children:"string"})}),e.jsx("td",{children:"✅"}),e.jsx("td",{children:"Price Point ID"})]})]})]}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Optional Fields:"})}),`
+`,e.jsxs(n.p,{children:["In addition to the two required fields ",e.jsx(n.code,{children:"sku"})," and ",e.jsx(n.code,{children:"offerPricePoint"}),", you can pass any other fields to each cart item. These additional fields will be saved to the order's ",e.jsx(n.code,{children:"metadata"})," and can be accessed later when retrieving order details through the ",e.jsx(n.code,{children:"useOrderDetail"})," hook."]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`const cart = [
+  {
+    sku: "TEST001",
+    offerPricePoint: "OPP-TEST001",
+    // Any other fields are allowed
+    title: "Product Title",
+    price: 99.99,
+    image: "https://example.com/product.jpg",
+    category: "Electronics",
+    // ... more fields
+  }
+];
+
+const { orderDetail } = useOrderDetail(orderCode)
+console.log(orderDetail.metadata.products)
+/** [
+  {
+    sku: "TEST001",
+    offerPricePoint: "OPP-TEST001",
+    title: "Product Title",
+    price: 99.99,
+    image: "https://example.com/product.jpg",
+    category: "Electronics",
+  }
+]
+**/
+`})}),`
+`,e.jsx(n.h4,{id:"oncheckoutinit",children:"onCheckoutInit"}),`
+`,e.jsxs(n.p,{children:["Callback function when checkout initializes, triggered immediately after the ",e.jsx(n.code,{children:"CheckoutPage"})," component mounts, used to track the start of the checkout flow."]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onCheckoutInit?: () => void
+`})}),`
+`,e.jsx(n.h4,{id:"onpaymentinfocomplete",children:"onPaymentInfoComplete"}),`
+`,e.jsx(n.p,{children:"Callback function when payment information is complete, triggered when the user completes the payment form and payment element validation passes."}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onPaymentInfoComplete?: (products: CheckoutCartItem[], totalAmount: number) => void
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Parameter Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"products"})," - Cart items array, type ",e.jsx(n.code,{children:"CheckoutCartItem[]"}),". Returns an array of cart items. See ",e.jsx(n.a,{href:"#checkoutcartitem",children:"CheckoutCartItem Type Definition"})," for details"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"totalAmount"})," - Total payment amount in cents (e.g., 9999 represents $99.99). For multiple items, this is the sum of all items"]}),`
+`]}),`
+`,e.jsx(n.h4,{id:"onordersubmit",children:"onOrderSubmit"}),`
+`,e.jsx(n.p,{children:"Callback function when order is submitted, triggered after the user clicks the submit button and before order processing begins."}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onOrderSubmit?: (products: CheckoutCartItem[], totalAmount: number) => void
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Parameter Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"products"})," - Submitted cart items array, type ",e.jsx(n.code,{children:"CheckoutCartItem[]"}),". See ",e.jsx(n.a,{href:"#checkoutcartitem",children:"CheckoutCartItem Type Definition"})," for details"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"totalAmount"})," - Total amount at submission time in cents (e.g., 9999 represents $99.99)"]}),`
+`]}),`
+`,e.jsx(n.h4,{id:"onordersuccess",children:"onOrderSuccess"}),`
+`,e.jsx(n.p,{children:"Callback function when order succeeds, triggered after the order is successfully created."}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onOrderSuccess?: (orderCode: string, tradeCode?: string) => void
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Parameter Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"orderCode"})," - Order code"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"tradeCode"})," - Trade code (optional)"]}),`
+`]}),`
+`,e.jsx(n.h3,{id:"usage-examples",children:"Usage Examples"}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`import { CheckoutPage } from '@clickaroo/checkout-ui';
+
+function App() {
+  const cart = [
+    {
+      sku: "TEST001",
+      offerPricePoint: "OPP-TEST001",
+    }
+  ];
+
+  return (
+    <CheckoutPage 
+      cart={cart}
+      onCheckoutInit={() => {
+        console.log('Checkout initialized');
+      }}
+      onPaymentInfoComplete={(products, totalAmount) => {
+        console.log('Payment info complete');
+        console.log('Total amount:', totalAmount / 100);
+        products.forEach((product) => {
+          console.log('Product SKU:', product.sku);
+          console.log('Unit price:', product.priceInCents / 100, product.currency);
+          console.log('Quantity:', product.quantity);
+          console.log('Payment type:', product.paymentType);
+        });
+      }}
+      onOrderSubmit={(products, totalAmount) => {
+        console.log('Order submitted');
+        console.log('Total amount:', totalAmount / 100);
+      }}
+      onOrderSuccess={(orderCode, tradeCode) => {
+        console.log('Order successful', orderCode, tradeCode);
+      }}
+    />
+  );
+}
+`})}),`
+`,e.jsx(n.h3,{id:"key-types",children:"Key Types"}),`
+`,e.jsx(n.h4,{id:"cartitem",children:"CartItem"}),`
+`,e.jsxs(n.p,{children:[e.jsx(n.code,{children:"CartItem"})," is the basic cart item type passed to the ",e.jsx(n.code,{children:"CheckoutPage"})," component:"]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`interface CartItem {
+  // Required fields
+  sku: string;                    // Product SKU
+  offerPricePoint: string;        // Price Point ID
+  
+  // Optional fields - allows any custom fields, which will be saved to order metadata
+  [key: string]: unknown;
+}
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Field Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"sku"})," - Product SKU, required field"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"offerPricePoint"})," - Price Point ID, required field"]}),`
+`,e.jsxs(n.li,{children:["Other fields - You can pass any additional fields (such as ",e.jsx(n.code,{children:"title"}),", ",e.jsx(n.code,{children:"price"}),", ",e.jsx(n.code,{children:"image"}),", etc.), which will be saved to the order's ",e.jsx(n.code,{children:"metadata"})," and can be retrieved through ",e.jsx(n.code,{children:"useOrderDetail"})]}),`
+`]}),`
+`,e.jsx(n.h4,{id:"checkoutcartitem",children:"CheckoutCartItem"}),`
+`,e.jsxs(n.p,{children:[e.jsx(n.code,{children:"CheckoutCartItem"})," is the cart item type returned in callback functions, extending ",e.jsx(n.code,{children:"CartItem"})," and including price details:"]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`interface CheckoutCartItem extends CartItem {
+  // Inherits all fields from CartItem (sku, offerPricePoint, etc.)
+  priceInCents: number;           // Unit price in cents (e.g., 9999 represents $99.99)
+  currency: string;               // Currency type (e.g., "USD", "EUR")
+  quantity: number;               // Quantity
+  paymentType: "one-time" | "subscription";  // Payment type
+}
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Field Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:["Inherits all fields from ",e.jsx(n.code,{children:"CartItem"})," (such as ",e.jsx(n.code,{children:"sku"}),", ",e.jsx(n.code,{children:"offerPricePoint"}),", etc.)"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"priceInCents"})," - Unit price in cents"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"currency"})," - Currency type"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"quantity"})," - Quantity"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"paymentType"})," - Payment type: ",e.jsx(n.code,{children:'"one-time"'})," for one-time payment, ",e.jsx(n.code,{children:'"subscription"'})," for subscription payment"]}),`
+`]})]})}function T(t={}){const{wrapper:n}={...c(),...t.components};return n?e.jsx(n,{...t,children:e.jsx(i,{...t})}):i(t)}export{T as default};

package/dist/storybook/storybook-static/assets/CheckoutPage.en-DLb_7NPf.js

@@ -0,0 +1,147 @@
+import{j as e}from"./jsx-runtime-DiklIkkE.js";import{useMDXComponents as c}from"./index-ChEI-nsM.js";import{M as s,C as o,a as d}from"./index-BlPVJQpb.js";import{C as l,D as r}from"./CheckoutPage.stories-BahbUp4O.js";import"./index-DRjF_FHU.js";import"./iframe-CueR_wS4.js";import"./index-B7ki2Uzk.js";import"./index-D-Mha1DF.js";import"./index-DrFu-skq.js";import"./useCheckoutContext-BXtGY5u3.js";import"./CheckoutPage-d8MZfjpI.js";import"./CustomerInfo-BwyY9803.js";import"./ValidateInput-LNzX4jJP.js";import"./DeliveryAddress-QAGxLlLf.js";import"./PaymentMethods-afz1CTO5.js";function i(t){const n={a:"a",code:"code",h1:"h1",h3:"h3",h4:"h4",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...c(),...t.components};return e.jsxs(e.Fragment,{children:[e.jsx(s,{of:l,title:"Documentation/Usage Guide/CheckoutPage",name:"CheckoutPage (English)"}),`
+`,e.jsx(n.h1,{id:"checkoutpage",children:"CheckoutPage"}),`
+`,e.jsx(n.p,{children:"A complete checkout page component that integrates customer information, delivery address, payment methods, and order submission functionality."}),`
+`,e.jsx(n.h3,{id:"basic-usage",children:"Basic Usage"}),`
+`,e.jsx(o,{of:r}),`
+`,e.jsx(n.h3,{id:"props",children:"Props"}),`
+`,e.jsx(d,{of:r}),`
+`,e.jsx(n.h4,{id:"cart",children:"cart"}),`
+`,e.jsx(n.p,{children:"Array of cart items. Each item represents a product in the checkout."}),`
+`,e.jsxs(n.p,{children:["Type: ",e.jsx(n.code,{children:"CartItem[]"}),". See ",e.jsx(n.a,{href:"#cartitem",children:"CartItem Type Definition"})," for details."]}),`
+`,e.jsx(n.p,{children:"Each cart item contains the following fields:"}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Required Fields:"})}),`
+`,e.jsxs("table",{children:[e.jsx("thead",{children:e.jsxs("tr",{children:[e.jsx("th",{children:"Field"}),e.jsx("th",{children:"Type"}),e.jsx("th",{children:"Required"}),e.jsx("th",{children:"Description"})]})}),e.jsxs("tbody",{children:[e.jsxs("tr",{children:[e.jsx("td",{children:e.jsx("code",{children:"sku"})}),e.jsx("td",{children:e.jsx("code",{children:"string"})}),e.jsx("td",{children:"✅"}),e.jsx("td",{children:"Product SKU"})]}),e.jsxs("tr",{children:[e.jsx("td",{children:e.jsx("code",{children:"offerPricePoint"})}),e.jsx("td",{children:e.jsx("code",{children:"string"})}),e.jsx("td",{children:"✅"}),e.jsx("td",{children:"Price Point ID"})]})]})]}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Optional Fields:"})}),`
+`,e.jsxs(n.p,{children:["In addition to the two required fields ",e.jsx(n.code,{children:"sku"})," and ",e.jsx(n.code,{children:"offerPricePoint"}),", you can pass any other fields to each cart item. These additional fields will be saved to the order's ",e.jsx(n.code,{children:"metadata"})," and can be accessed later when retrieving order details through the ",e.jsx(n.code,{children:"useOrderDetail"})," hook."]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`const cart = [
+  {
+    sku: "TEST001",
+    offerPricePoint: "OPP-TEST001",
+    // Any other fields are allowed
+    title: "Product Title",
+    price: 99.99,
+    image: "https://example.com/product.jpg",
+    category: "Electronics",
+    // ... more fields
+  }
+];
+
+const { orderDetail } = useOrderDetail(orderCode)
+console.log(orderDetail.metadata.products)
+/** [
+  {
+    sku: "TEST001",
+    offerPricePoint: "OPP-TEST001",
+    title: "Product Title",
+    price: 99.99,
+    image: "https://example.com/product.jpg",
+    category: "Electronics",
+  }
+]
+**/
+`})}),`
+`,e.jsx(n.h4,{id:"oncheckoutinit",children:"onCheckoutInit"}),`
+`,e.jsxs(n.p,{children:["Callback function when checkout initializes, triggered immediately after the ",e.jsx(n.code,{children:"CheckoutPage"})," component mounts, used to track the start of the checkout flow."]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onCheckoutInit?: () => void
+`})}),`
+`,e.jsx(n.h4,{id:"onpaymentinfocomplete",children:"onPaymentInfoComplete"}),`
+`,e.jsx(n.p,{children:"Callback function when payment information is complete, triggered when the user completes the payment form and payment element validation passes."}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onPaymentInfoComplete?: (products: CheckoutCartItem[], totalAmount: number) => void
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Parameter Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"products"})," - Cart items array, type ",e.jsx(n.code,{children:"CheckoutCartItem[]"}),". Returns an array of cart items. See ",e.jsx(n.a,{href:"#checkoutcartitem",children:"CheckoutCartItem Type Definition"})," for details"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"totalAmount"})," - Total payment amount in cents (e.g., 9999 represents $99.99). For multiple items, this is the sum of all items"]}),`
+`]}),`
+`,e.jsx(n.h4,{id:"onordersubmit",children:"onOrderSubmit"}),`
+`,e.jsx(n.p,{children:"Callback function when order is submitted, triggered after the user clicks the submit button and before order processing begins."}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onOrderSubmit?: (products: CheckoutCartItem[], totalAmount: number) => void
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Parameter Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"products"})," - Submitted cart items array, type ",e.jsx(n.code,{children:"CheckoutCartItem[]"}),". See ",e.jsx(n.a,{href:"#checkoutcartitem",children:"CheckoutCartItem Type Definition"})," for details"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"totalAmount"})," - Total amount at submission time in cents (e.g., 9999 represents $99.99)"]}),`
+`]}),`
+`,e.jsx(n.h4,{id:"onordersuccess",children:"onOrderSuccess"}),`
+`,e.jsx(n.p,{children:"Callback function when order succeeds, triggered after the order is successfully created."}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`onOrderSuccess?: (orderCode: string, tradeCode?: string) => void
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Parameter Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"orderCode"})," - Order code"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"tradeCode"})," - Trade code (optional)"]}),`
+`]}),`
+`,e.jsx(n.h3,{id:"usage-examples",children:"Usage Examples"}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`import { CheckoutPage } from '@clickaroo/checkout-ui';
+
+function App() {
+  const cart = [
+    {
+      sku: "TEST001",
+      offerPricePoint: "OPP-TEST001",
+    }
+  ];
+
+  return (
+    <CheckoutPage 
+      cart={cart}
+      onCheckoutInit={() => {
+        console.log('Checkout initialized');
+      }}
+      onPaymentInfoComplete={(products, totalAmount) => {
+        console.log('Payment info complete');
+        console.log('Total amount:', totalAmount / 100);
+        products.forEach((product) => {
+          console.log('Product SKU:', product.sku);
+          console.log('Unit price:', product.priceInCents / 100, product.currency);
+          console.log('Quantity:', product.quantity);
+          console.log('Payment type:', product.paymentType);
+        });
+      }}
+      onOrderSubmit={(products, totalAmount) => {
+        console.log('Order submitted');
+        console.log('Total amount:', totalAmount / 100);
+      }}
+      onOrderSuccess={(orderCode, tradeCode) => {
+        console.log('Order successful', orderCode, tradeCode);
+      }}
+    />
+  );
+}
+`})}),`
+`,e.jsx(n.h3,{id:"key-types",children:"Key Types"}),`
+`,e.jsx(n.h4,{id:"cartitem",children:"CartItem"}),`
+`,e.jsxs(n.p,{children:[e.jsx(n.code,{children:"CartItem"})," is the basic cart item type passed to the ",e.jsx(n.code,{children:"CheckoutPage"})," component:"]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`interface CartItem {
+  // Required fields
+  sku: string;                    // Product SKU
+  offerPricePoint: string;        // Price Point ID
+  
+  // Optional fields - allows any custom fields, which will be saved to order metadata
+  [key: string]: unknown;
+}
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Field Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"sku"})," - Product SKU, required field"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"offerPricePoint"})," - Price Point ID, required field"]}),`
+`,e.jsxs(n.li,{children:["Other fields - You can pass any additional fields (such as ",e.jsx(n.code,{children:"title"}),", ",e.jsx(n.code,{children:"price"}),", ",e.jsx(n.code,{children:"image"}),", etc.), which will be saved to the order's ",e.jsx(n.code,{children:"metadata"})," and can be retrieved through ",e.jsx(n.code,{children:"useOrderDetail"})]}),`
+`]}),`
+`,e.jsx(n.h4,{id:"checkoutcartitem",children:"CheckoutCartItem"}),`
+`,e.jsxs(n.p,{children:[e.jsx(n.code,{children:"CheckoutCartItem"})," is the cart item type returned in callback functions, extending ",e.jsx(n.code,{children:"CartItem"})," and including price details:"]}),`
+`,e.jsx(n.pre,{children:e.jsx(n.code,{className:"language-tsx",children:`interface CheckoutCartItem extends CartItem {
+  // Inherits all fields from CartItem (sku, offerPricePoint, etc.)
+  priceInCents: number;           // Unit price in cents (e.g., 9999 represents $99.99)
+  currency: string;               // Currency type (e.g., "USD", "EUR")
+  quantity: number;               // Quantity
+  paymentType: "one-time" | "subscription";  // Payment type
+}
+`})}),`
+`,e.jsx(n.p,{children:e.jsx(n.strong,{children:"Field Description:"})}),`
+`,e.jsxs(n.ul,{children:[`
+`,e.jsxs(n.li,{children:["Inherits all fields from ",e.jsx(n.code,{children:"CartItem"})," (such as ",e.jsx(n.code,{children:"sku"}),", ",e.jsx(n.code,{children:"offerPricePoint"}),", etc.)"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"priceInCents"})," - Unit price in cents"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"currency"})," - Currency type"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"quantity"})," - Quantity"]}),`
+`,e.jsxs(n.li,{children:[e.jsx(n.code,{children:"paymentType"})," - Payment type: ",e.jsx(n.code,{children:'"one-time"'})," for one-time payment, ",e.jsx(n.code,{children:'"subscription"'})," for subscription payment"]}),`
+`]})]})}function T(t={}){const{wrapper:n}={...c(),...t.components};return n?e.jsx(n,{...t,children:e.jsx(i,{...t})}):i(t)}export{T as default};