@rovela-ai/sdk 0.4.1 → 0.4.2

package/dist/checkout/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/checkout/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBnB,CAAA;AAEV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAMnE;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDZ,CAAA;AAEV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAM5D;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEjE"}

package/dist/checkout/constants.js

@@ -0,0 +1,119 @@
+/**
+ * @rovela/sdk/checkout/constants
+ *
+ * Shared constants for shipping address forms.
+ * Used by both customer checkout (ShippingForm) and admin (ShippingSettings).
+ */
+// =============================================================================
+// Country List
+// =============================================================================
+/**
+ * Common countries for shipping address selection.
+ * Sorted by most common shipping destinations first.
+ */
+export const COMMON_COUNTRIES = [
+    { code: 'US', name: 'United States' },
+    { code: 'CA', name: 'Canada' },
+    { code: 'GB', name: 'United Kingdom' },
+    { code: 'AU', name: 'Australia' },
+    { code: 'DE', name: 'Germany' },
+    { code: 'FR', name: 'France' },
+    { code: 'IT', name: 'Italy' },
+    { code: 'ES', name: 'Spain' },
+    { code: 'NL', name: 'Netherlands' },
+    { code: 'BE', name: 'Belgium' },
+    { code: 'AT', name: 'Austria' },
+    { code: 'CH', name: 'Switzerland' },
+    { code: 'SE', name: 'Sweden' },
+    { code: 'NO', name: 'Norway' },
+    { code: 'DK', name: 'Denmark' },
+    { code: 'FI', name: 'Finland' },
+    { code: 'IE', name: 'Ireland' },
+    { code: 'NZ', name: 'New Zealand' },
+    { code: 'JP', name: 'Japan' },
+    { code: 'SG', name: 'Singapore' },
+];
+// =============================================================================
+// US States List
+// =============================================================================
+/**
+ * US states for address selection.
+ * Only shown when country is 'US'.
+ */
+export const US_STATES = [
+    { code: 'AL', name: 'Alabama' },
+    { code: 'AK', name: 'Alaska' },
+    { code: 'AZ', name: 'Arizona' },
+    { code: 'AR', name: 'Arkansas' },
+    { code: 'CA', name: 'California' },
+    { code: 'CO', name: 'Colorado' },
+    { code: 'CT', name: 'Connecticut' },
+    { code: 'DE', name: 'Delaware' },
+    { code: 'FL', name: 'Florida' },
+    { code: 'GA', name: 'Georgia' },
+    { code: 'HI', name: 'Hawaii' },
+    { code: 'ID', name: 'Idaho' },
+    { code: 'IL', name: 'Illinois' },
+    { code: 'IN', name: 'Indiana' },
+    { code: 'IA', name: 'Iowa' },
+    { code: 'KS', name: 'Kansas' },
+    { code: 'KY', name: 'Kentucky' },
+    { code: 'LA', name: 'Louisiana' },
+    { code: 'ME', name: 'Maine' },
+    { code: 'MD', name: 'Maryland' },
+    { code: 'MA', name: 'Massachusetts' },
+    { code: 'MI', name: 'Michigan' },
+    { code: 'MN', name: 'Minnesota' },
+    { code: 'MS', name: 'Mississippi' },
+    { code: 'MO', name: 'Missouri' },
+    { code: 'MT', name: 'Montana' },
+    { code: 'NE', name: 'Nebraska' },
+    { code: 'NV', name: 'Nevada' },
+    { code: 'NH', name: 'New Hampshire' },
+    { code: 'NJ', name: 'New Jersey' },
+    { code: 'NM', name: 'New Mexico' },
+    { code: 'NY', name: 'New York' },
+    { code: 'NC', name: 'North Carolina' },
+    { code: 'ND', name: 'North Dakota' },
+    { code: 'OH', name: 'Ohio' },
+    { code: 'OK', name: 'Oklahoma' },
+    { code: 'OR', name: 'Oregon' },
+    { code: 'PA', name: 'Pennsylvania' },
+    { code: 'RI', name: 'Rhode Island' },
+    { code: 'SC', name: 'South Carolina' },
+    { code: 'SD', name: 'South Dakota' },
+    { code: 'TN', name: 'Tennessee' },
+    { code: 'TX', name: 'Texas' },
+    { code: 'UT', name: 'Utah' },
+    { code: 'VT', name: 'Vermont' },
+    { code: 'VA', name: 'Virginia' },
+    { code: 'WA', name: 'Washington' },
+    { code: 'WV', name: 'West Virginia' },
+    { code: 'WI', name: 'Wisconsin' },
+    { code: 'WY', name: 'Wyoming' },
+    { code: 'DC', name: 'District of Columbia' },
+];
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Get country name from code.
+ */
+export function getCountryName(code) {
+    const country = COMMON_COUNTRIES.find((c) => c.code === code);
+    return country?.name || code;
+}
+/**
+ * Get state name from code (US only).
+ */
+export function getStateName(code) {
+    const state = US_STATES.find((s) => s.code === code);
+    return state?.name || code;
+}
+/**
+ * Check if a country code requires state selection.
+ */
+export function countryRequiresState(countryCode) {
+    return countryCode === 'US';
+}
+//# sourceMappingURL=constants.js.map

package/dist/checkout/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/checkout/constants.ts"],"names":[],"mappings":"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"}

package/dist/checkout/hooks/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @rovela/sdk/checkout/hooks
+ *
+ * React hooks for checkout
+ */
+export { useCheckout } from './useCheckout';
+export { usePaymentStatus } from './usePaymentStatus';
+export type { UsePaymentStatusReturn } from './usePaymentStatus';
+//# sourceMappingURL=index.d.ts.map

package/dist/checkout/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/checkout/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/checkout/hooks/index.js

@@ -0,0 +1,8 @@
+/**
+ * @rovela/sdk/checkout/hooks
+ *
+ * React hooks for checkout
+ */
+export { useCheckout } from './useCheckout';
+export { usePaymentStatus } from './usePaymentStatus';
+//# sourceMappingURL=index.js.map

package/dist/checkout/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/checkout/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/checkout/hooks/useCheckout.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @rovela/sdk/checkout/hooks/useCheckout
+ *
+ * React hook for initiating Stripe Checkout.
+ */
+import type { UseCheckoutOptions, UseCheckoutReturn } from '../types';
+/**
+ * Hook for initiating Stripe Checkout.
+ *
+ * Automatically reads cart items and creates a checkout session.
+ * Redirects to Stripe's hosted checkout page.
+ *
+ * @example
+ * ```tsx
+ * import { useCheckout } from '@rovela/sdk/checkout'
+ *
+ * function CheckoutButton() {
+ *   const { checkout, isLoading, error } = useCheckout()
+ *
+ *   return (
+ *     <button onClick={checkout} disabled={isLoading}>
+ *       {isLoading ? 'Redirecting...' : 'Checkout'}
+ *     </button>
+ *   )
+ * }
+ * ```
+ *
+ * @example With custom options
+ * ```tsx
+ * const { checkout } = useCheckout({
+ *   onSuccess: (session) => console.log('Session created:', session.sessionId),
+ *   onError: (error) => alert(error.error),
+ *   customerEmail: 'customer@example.com',
+ * })
+ * ```
+ */
+export declare function useCheckout(options?: UseCheckoutOptions): UseCheckoutReturn;
+//# sourceMappingURL=useCheckout.d.ts.map

package/dist/checkout/hooks/useCheckout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCheckout.d.ts","sourceRoot":"","sources":["../../../src/checkout/hooks/useCheckout.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAGV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,UAAU,CAAA;AAMjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,CAsG3E"}

package/dist/checkout/hooks/useCheckout.js

@@ -0,0 +1,134 @@
+/**
+ * @rovela/sdk/checkout/hooks/useCheckout
+ *
+ * React hook for initiating Stripe Checkout.
+ */
+'use client';
+import { useState, useCallback } from 'react';
+import { getCartItemsWithFallback } from '../../cart/store';
+// =============================================================================
+// Hook
+// =============================================================================
+/**
+ * Hook for initiating Stripe Checkout.
+ *
+ * Automatically reads cart items and creates a checkout session.
+ * Redirects to Stripe's hosted checkout page.
+ *
+ * @example
+ * ```tsx
+ * import { useCheckout } from '@rovela/sdk/checkout'
+ *
+ * function CheckoutButton() {
+ *   const { checkout, isLoading, error } = useCheckout()
+ *
+ *   return (
+ *     <button onClick={checkout} disabled={isLoading}>
+ *       {isLoading ? 'Redirecting...' : 'Checkout'}
+ *     </button>
+ *   )
+ * }
+ * ```
+ *
+ * @example With custom options
+ * ```tsx
+ * const { checkout } = useCheckout({
+ *   onSuccess: (session) => console.log('Session created:', session.sessionId),
+ *   onError: (error) => alert(error.error),
+ *   customerEmail: 'customer@example.com',
+ * })
+ * ```
+ */
+export function useCheckout(options) {
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const checkout = useCallback(async () => {
+        // Reset error state
+        setError(null);
+        // Get cart items with fallback for module duplication issues
+        // This handles cases where the useCart instance here may be different
+        // from the one CartProvider hydrated (webpack code splitting issue)
+        const items = getCartItemsWithFallback();
+        // Validate cart
+        if (items.length === 0) {
+            const emptyError = {
+                error: 'Your cart is empty',
+                code: 'EMPTY_CART',
+            };
+            setError(emptyError);
+            options?.onError?.(emptyError);
+            return;
+        }
+        setIsLoading(true);
+        try {
+            // Build request body
+            const body = {
+                items: items.map((item) => ({
+                    productId: item.productId,
+                    variantId: item.variantId,
+                    name: item.name,
+                    description: item.attributes
+                        ? Object.entries(item.attributes)
+                            .map(([k, v]) => `${k}: ${v}`)
+                            .join(', ')
+                        : undefined,
+                    // Convert dollars to cents for Stripe
+                    price: Math.round(item.price * 100),
+                    quantity: item.quantity,
+                    image: item.image,
+                })),
+                customerEmail: options?.customerEmail,
+                customerId: options?.customerId,
+                successUrl: options?.successUrl,
+                cancelUrl: options?.cancelUrl,
+                metadata: options?.metadata,
+                // Pre-checkout flow: Pass shipping address and selected option
+                // When provided, Stripe Checkout will use pre-selected shipping (as line item)
+                // instead of showing multiple shipping options to choose from
+                shippingAddress: options?.shippingAddress,
+                selectedShipping: options?.selectedShipping,
+            };
+            // Call checkout API
+            const response = await fetch('/api/checkout', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(body),
+            });
+            const data = await response.json();
+            if (!response.ok) {
+                const apiError = data;
+                setError(apiError);
+                options?.onError?.(apiError);
+                return;
+            }
+            const session = data;
+            // Call success callback
+            options?.onSuccess?.(session);
+            // NOTE: Cart is NOT cleared here. Cart is cleared on the success page
+            // (checkout/success/page.tsx) AFTER payment is confirmed.
+            // This ensures users retain their cart if they cancel checkout or payment fails.
+            // Redirect to Stripe Checkout
+            if (session.url) {
+                window.location.href = session.url;
+            }
+        }
+        catch (err) {
+            const networkError = {
+                error: 'Network error. Please try again.',
+                code: 'CHECKOUT_ERROR',
+            };
+            setError(networkError);
+            options?.onError?.(networkError);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [options]);
+    return {
+        checkout,
+        isLoading,
+        error,
+        clearError: useCallback(() => setError(null), []),
+    };
+}
+//# sourceMappingURL=useCheckout.js.map

package/dist/checkout/hooks/useCheckout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCheckout.js","sourceRoot":"","sources":["../../../src/checkout/hooks/useCheckout.ts"],"names":[],"mappings":"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"}

package/dist/checkout/hooks/usePaymentStatus.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @rovela/sdk/checkout/hooks/usePaymentStatus
+ *
+ * React hook for checking if payments are configured.
+ * Use this to conditionally render checkout UI.
+ */
+export interface UsePaymentStatusReturn {
+    /** Whether the store can accept payments */
+    canAcceptPayments: boolean;
+    /** Payment configuration status */
+    status: 'loading' | 'active' | 'not_configured' | 'incomplete' | 'restricted' | 'pending' | 'error';
+    /** Human-readable message */
+    message: string;
+    /** Whether the hook is still loading */
+    isLoading: boolean;
+    /** Refresh the payment status */
+    refresh: () => void;
+}
+/**
+ * Hook for checking if payments are configured for this store.
+ *
+ * @example
+ * ```tsx
+ * import { usePaymentStatus, CheckoutButton } from '@rovela/sdk/checkout'
+ *
+ * function CartFooter() {
+ *   const { canAcceptPayments, status, message } = usePaymentStatus()
+ *
+ *   if (!canAcceptPayments) {
+ *     return (
+ *       <div className="text-amber-600 text-sm">
+ *         {message}
+ *       </div>
+ *     )
+ *   }
+ *
+ *   return <CheckoutButton />
+ * }
+ * ```
+ */
+export declare function usePaymentStatus(): UsePaymentStatusReturn;
+//# sourceMappingURL=usePaymentStatus.d.ts.map

package/dist/checkout/hooks/usePaymentStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePaymentStatus.d.ts","sourceRoot":"","sources":["../../../src/checkout/hooks/usePaymentStatus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,iBAAiB,EAAE,OAAO,CAAA;IAC1B,mCAAmC;IACnC,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,gBAAgB,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,CAAA;IACnG,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAA;IAClB,iCAAiC;IACjC,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CA8CzD"}

package/dist/checkout/hooks/usePaymentStatus.js

@@ -0,0 +1,71 @@
+/**
+ * @rovela/sdk/checkout/hooks/usePaymentStatus
+ *
+ * React hook for checking if payments are configured.
+ * Use this to conditionally render checkout UI.
+ */
+'use client';
+import { useState, useEffect, useCallback } from 'react';
+// =============================================================================
+// Hook
+// =============================================================================
+/**
+ * Hook for checking if payments are configured for this store.
+ *
+ * @example
+ * ```tsx
+ * import { usePaymentStatus, CheckoutButton } from '@rovela/sdk/checkout'
+ *
+ * function CartFooter() {
+ *   const { canAcceptPayments, status, message } = usePaymentStatus()
+ *
+ *   if (!canAcceptPayments) {
+ *     return (
+ *       <div className="text-amber-600 text-sm">
+ *         {message}
+ *       </div>
+ *     )
+ *   }
+ *
+ *   return <CheckoutButton />
+ * }
+ * ```
+ */
+export function usePaymentStatus() {
+    const [state, setState] = useState({
+        canAcceptPayments: false,
+        status: 'loading',
+        message: 'Checking payment status...',
+    });
+    const fetchStatus = useCallback(async () => {
+        setState((prev) => ({ ...prev, status: 'loading' }));
+        try {
+            const response = await fetch('/api/checkout/status');
+            if (!response.ok) {
+                throw new Error('Failed to check payment status');
+            }
+            const data = (await response.json());
+            setState({
+                canAcceptPayments: data.canAcceptPayments,
+                status: data.status,
+                message: data.message,
+            });
+        }
+        catch (error) {
+            setState({
+                canAcceptPayments: false,
+                status: 'error',
+                message: 'Unable to verify payment configuration.',
+            });
+        }
+    }, []);
+    useEffect(() => {
+        fetchStatus();
+    }, [fetchStatus]);
+    return {
+        ...state,
+        isLoading: state.status === 'loading',
+        refresh: fetchStatus,
+    };
+}
+//# sourceMappingURL=usePaymentStatus.js.map

package/dist/checkout/hooks/usePaymentStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePaymentStatus.js","sourceRoot":"","sources":["../../../src/checkout/hooks/usePaymentStatus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,CAAA;AAEZ,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAoBxD,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAI/B;QACD,iBAAiB,EAAE,KAAK;QACxB,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,4BAA4B;KACtC,CAAC,CAAA;IAEF,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACzC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;QAEpD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,sBAAsB,CAAC,CAAA;YAEpD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;YACnD,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA0B,CAAA;YAE7D,QAAQ,CAAC;gBACP,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;gBACzC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC;gBACP,iBAAiB,EAAE,KAAK;gBACxB,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,yCAAyC;aACnD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,EAAE,CAAA;IACf,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAA;IAEjB,OAAO;QACL,GAAG,KAAK;QACR,SAAS,EAAE,KAAK,CAAC,MAAM,KAAK,SAAS;QACrC,OAAO,EAAE,WAAW;KACrB,CAAA;AACH,CAAC"}

package/dist/checkout/index.js

@@ -0,0 +1,135 @@
+/**
+ * @rovela/sdk/checkout
+ *
+ * Stripe Checkout integration with Direct Charges for connected accounts.
+ *
+ * ## Overview
+ *
+ * This module provides complete Stripe Checkout integration:
+ * - Stripe Checkout (hosted) for payment collection
+ * - Direct Charges to connected accounts
+ * - Automatic platform fee calculation
+ * - Webhook handling for order creation
+ *
+ * ## Quick Start
+ *
+ * ### 1. Environment Variables
+ *
+ * ```env
+ * # Platform (Rovela) credentials
+ * STRIPE_SECRET_KEY=sk_live_...
+ * STRIPE_PUBLISHABLE_KEY=pk_live_...
+ * STRIPE_WEBHOOK_SECRET=whsec_...
+ *
+ * # Per-store connected account (set during store setup)
+ * STRIPE_CONNECTED_ACCOUNT_ID=acct_...
+ *
+ * # Optional configuration
+ * STRIPE_PLATFORM_FEE_PERCENT=5    # Platform takes 5%
+ * STORE_CURRENCY=USD               # Store currency
+ * ```
+ *
+ * ### 2. API Routes
+ *
+ * ```typescript
+ * // app/api/checkout/route.ts
+ * export { POST } from '@rovela/sdk/checkout/api'
+ *
+ * // app/api/webhooks/stripe/route.ts
+ * import { handleStripeWebhook } from '@rovela/sdk/checkout/server'
+ *
+ * export async function POST(request: Request) {
+ *   const payload = await request.text()
+ *   const signature = request.headers.get('stripe-signature')!
+ *   const result = await handleStripeWebhook(payload, signature)
+ *   return Response.json(result)
+ * }
+ * ```
+ *
+ * ### 3. Checkout Button
+ *
+ * ```tsx
+ * // In your cart or product page
+ * import { CheckoutButton } from '@rovela/sdk/checkout'
+ *
+ * function Cart() {
+ *   return (
+ *     <div>
+ *       <CartItems />
+ *       <CartSummary />
+ *       <CheckoutButton size="lg" fullWidth>
+ *         Proceed to Checkout
+ *       </CheckoutButton>
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * ### 4. Success Page
+ *
+ * ```tsx
+ * // app/checkout/success/page.tsx
+ * import { CheckoutSuccess } from '@rovela/sdk/checkout'
+ * import { useCart } from '@rovela/sdk/cart'
+ *
+ * export default function SuccessPage() {
+ *   const { clearCart } = useCart()
+ *
+ *   return (
+ *     <CheckoutSuccess
+ *       continueShoppingHref="/products"
+ *       viewOrderHref="/account/orders/{orderId}"
+ *       onMount={clearCart}
+ *     />
+ *   )
+ * }
+ * ```
+ *
+ * ## Architecture
+ *
+ * ```
+ * Cart → CheckoutButton → /api/checkout → Stripe Checkout (hosted)
+ *                                              ↓
+ * Database ← Webhook ← /api/webhooks/stripe ← Stripe
+ *                              ↓
+ *                     Order Created
+ * ```
+ *
+ * ## Direct Charges Model
+ *
+ * With Direct Charges, payments are made directly on the connected account:
+ * - Payment shows connected account name on customer statement
+ * - Connected account handles disputes
+ * - Platform collects application fee automatically
+ */
+// =============================================================================
+// Components
+// =============================================================================
+export { CheckoutButton, CheckoutFlow, CheckoutSuccess, OrderSummary, ShippingForm, ShippingOptions, } from './components';
+// =============================================================================
+// Hooks
+// =============================================================================
+export { useCheckout, usePaymentStatus } from './hooks';
+// =============================================================================
+// Server Functions
+// =============================================================================
+export { 
+// Session creation
+createCheckoutSession, getCheckoutSession, 
+// Order management
+createOrderFromCheckout, extractOrderParamsFromSession, handleRefund, 
+// Webhook handler
+handleStripeWebhook, } from './server';
+// =============================================================================
+// API Route Handlers
+// =============================================================================
+export { CountriesGET } from './api';
+// =============================================================================
+// Stripe Client Utilities
+// =============================================================================
+export { getStripe, getConnectedAccountId, hasConnectedAccount, getPlatformFeePercent, calculateApplicationFee, getWebhookSecret, getStoreCurrency, getAllowedShippingCountries, getPublishableKey, } from './stripe';
+// =============================================================================
+// Address Constants & Utilities
+// =============================================================================
+export { COMMON_COUNTRIES, US_STATES, getCountryName, getStateName, countryRequiresState, } from './constants';
+//# sourceMappingURL=index.js.map

package/dist/checkout/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/checkout/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuGG;AAwCH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,cAAc,CAAA;AAErB,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAGvD,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,OAAO;AACL,mBAAmB;AACnB,qBAAqB,EACrB,kBAAkB;AAClB,mBAAmB;AACnB,uBAAuB,EACvB,6BAA6B,EAC7B,YAAY;AACZ,kBAAkB;AAClB,mBAAmB,GACpB,MAAM,UAAU,CAAA;AAIjB,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,UAAU,CAAA;AAEjB,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAEhF,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,YAAY,EACZ,oBAAoB,GACrB,MAAM,aAAa,CAAA"}