@rovela-ai/sdk 0.4.1 → 0.4.2

package/dist/checkout/api/payment-status.js

@@ -0,0 +1,104 @@
+/**
+ * @rovela/sdk/checkout/api/payment-status
+ *
+ * API route handler for checking payment configuration status.
+ * Returns whether the store can accept payments.
+ *
+ * This handler verifies:
+ * 1. Environment variables are configured (STRIPE_SECRET_KEY, publishable key)
+ * 2. Connected account ID is set (STRIPE_CONNECTED_ACCOUNT_ID)
+ * 3. Connected account is active with charges_enabled (via Stripe API)
+ *
+ * Usage in Next.js App Router:
+ * ```typescript
+ * // app/api/checkout/status/route.ts
+ * export { GET } from '@rovela-ai/sdk/checkout/api/payment-status'
+ * ```
+ */
+import { NextResponse } from 'next/server';
+import { getStripe } from '../stripe/client';
+// =============================================================================
+// Handler
+// =============================================================================
+/**
+ * GET /api/checkout/status
+ *
+ * Checks if the store is configured to accept payments.
+ * Performs actual Stripe API call to verify account status.
+ *
+ * Response:
+ * - canAcceptPayments: boolean
+ * - status: 'active' | 'not_configured' | 'incomplete' | 'restricted' | 'pending'
+ * - message: Human-readable explanation
+ */
+export async function GET() {
+    // Check for connected account
+    const connectedAccountId = process.env.STRIPE_CONNECTED_ACCOUNT_ID;
+    if (!connectedAccountId) {
+        return NextResponse.json({
+            canAcceptPayments: false,
+            status: 'not_configured',
+            message: 'Payment setup is not complete. The store owner needs to connect their Stripe account.',
+        });
+    }
+    // Check for platform credentials
+    const secretKey = process.env.STRIPE_SECRET_KEY;
+    const publishableKey = process.env.NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY;
+    if (!secretKey || !publishableKey) {
+        return NextResponse.json({
+            canAcceptPayments: false,
+            status: 'incomplete',
+            message: 'Payment system configuration is incomplete.',
+        });
+    }
+    // Verify the connected account status with Stripe
+    try {
+        const stripe = getStripe();
+        const account = await stripe.accounts.retrieve(connectedAccountId);
+        const chargesEnabled = account.charges_enabled ?? false;
+        const payoutsEnabled = account.payouts_enabled ?? false;
+        const detailsSubmitted = account.details_submitted ?? false;
+        // Include details in development mode for debugging
+        const isDev = process.env.NODE_ENV === 'development';
+        const details = isDev
+            ? { chargesEnabled, payoutsEnabled, detailsSubmitted }
+            : undefined;
+        // Check if account can accept charges
+        if (!chargesEnabled) {
+            // Determine why charges are disabled
+            if (!detailsSubmitted) {
+                return NextResponse.json({
+                    canAcceptPayments: false,
+                    status: 'pending',
+                    message: 'Payment setup is pending. The store owner needs to complete Stripe onboarding.',
+                    details,
+                });
+            }
+            // Details submitted but charges still disabled = restricted
+            return NextResponse.json({
+                canAcceptPayments: false,
+                status: 'restricted',
+                message: 'Payment account is restricted. Please check your Stripe dashboard for required actions.',
+                details,
+            });
+        }
+        // All good - account is active and can accept charges
+        return NextResponse.json({
+            canAcceptPayments: true,
+            status: 'active',
+            message: 'Ready to accept payments.',
+            details,
+        });
+    }
+    catch (error) {
+        console.error('[Payment Status] Error verifying Stripe account:', error);
+        // If we can't verify, fall back to assuming configured but unknown
+        // This prevents blocking checkout if Stripe API is temporarily unavailable
+        return NextResponse.json({
+            canAcceptPayments: true,
+            status: 'active',
+            message: 'Payment system is configured.',
+        });
+    }
+}
+//# sourceMappingURL=payment-status.js.map

package/dist/checkout/api/payment-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-status.js","sourceRoot":"","sources":["../../../src/checkout/api/payment-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAqB5C,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG;IACvB,8BAA8B;IAC9B,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAA;IAElE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,OAAO,YAAY,CAAC,IAAI,CAAC;YACvB,iBAAiB,EAAE,KAAK;YACxB,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,uFAAuF;SACjG,CAAC,CAAA;IACJ,CAAC;IAED,iCAAiC;IACjC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAA;IAC/C,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAA;IAErE,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,EAAE,CAAC;QAClC,OAAO,YAAY,CAAC,IAAI,CAAC;YACvB,iBAAiB,EAAE,KAAK;YACxB,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,6CAA6C;SACvD,CAAC,CAAA;IACJ,CAAC;IAED,kDAAkD;IAClD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;QAC1B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAA;QAElE,MAAM,cAAc,GAAG,OAAO,CAAC,eAAe,IAAI,KAAK,CAAA;QACvD,MAAM,cAAc,GAAG,OAAO,CAAC,eAAe,IAAI,KAAK,CAAA;QACvD,MAAM,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,IAAI,KAAK,CAAA;QAE3D,oDAAoD;QACpD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAA;QACpD,MAAM,OAAO,GAAG,KAAK;YACnB,CAAC,CAAC,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE;YACtD,CAAC,CAAC,SAAS,CAAA;QAEb,sCAAsC;QACtC,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,qCAAqC;YACrC,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,OAAO,YAAY,CAAC,IAAI,CAAC;oBACvB,iBAAiB,EAAE,KAAK;oBACxB,MAAM,EAAE,SAAS;oBACjB,OAAO,EAAE,gFAAgF;oBACzF,OAAO;iBACR,CAAC,CAAA;YACJ,CAAC;YAED,4DAA4D;YAC5D,OAAO,YAAY,CAAC,IAAI,CAAC;gBACvB,iBAAiB,EAAE,KAAK;gBACxB,MAAM,EAAE,YAAY;gBACpB,OAAO,EAAE,yFAAyF;gBAClG,OAAO;aACR,CAAC,CAAA;QACJ,CAAC;QAED,sDAAsD;QACtD,OAAO,YAAY,CAAC,IAAI,CAAC;YACvB,iBAAiB,EAAE,IAAI;YACvB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,2BAA2B;YACpC,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,kDAAkD,EAAE,KAAK,CAAC,CAAA;QAExE,mEAAmE;QACnE,2EAA2E;QAC3E,OAAO,YAAY,CAAC,IAAI,CAAC;YACvB,iBAAiB,EAAE,IAAI;YACvB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,+BAA+B;SACzC,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}

package/dist/checkout/api/shipping.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @rovela/sdk/checkout/api/shipping
+ *
+ * API route handler for calculating shipping options.
+ * Supports both manual (zones/rates) and Shippo (carrier API) modes.
+ *
+ * Usage in Next.js App Router:
+ * ```typescript
+ * // app/api/checkout/shipping/route.ts
+ * export { ShippingPOST as POST } from '@rovela/sdk/checkout/api'
+ * ```
+ */
+import { NextRequest, NextResponse } from 'next/server';
+import type { ShippingCalculationResponse, CheckoutApiError } from '../types';
+/**
+ * POST /api/checkout/shipping
+ *
+ * Calculate available shipping options based on destination address.
+ * Automatically switches between manual (zones/rates) and Shippo (carrier API)
+ * modes based on store settings.
+ *
+ * Request Body:
+ * - address: Full shipping address (required)
+ * - items: Array of { price, quantity } for order total calculation (required)
+ *
+ * Response:
+ * - success: boolean
+ * - options: ShippingOptionsGroupedByCarrier[]
+ * - flatOptions: ShippingOption[]
+ * - mode: 'manual' | 'shippo'
+ * - error?: string (if calculation failed)
+ */
+export declare function POST(request: NextRequest): Promise<NextResponse<ShippingCalculationResponse | CheckoutApiError>>;
+//# sourceMappingURL=shipping.d.ts.map

package/dist/checkout/api/shipping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipping.d.ts","sourceRoot":"","sources":["../../../src/checkout/api/shipping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EACV,2BAA2B,EAG3B,gBAAgB,EACjB,MAAM,UAAU,CAAA;AAqCjB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,IAAI,CACxB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,2BAA2B,GAAG,gBAAgB,CAAC,CAAC,CA2PvE"}

package/dist/checkout/api/shipping.js

@@ -0,0 +1,247 @@
+/**
+ * @rovela/sdk/checkout/api/shipping
+ *
+ * API route handler for calculating shipping options.
+ * Supports both manual (zones/rates) and Shippo (carrier API) modes.
+ *
+ * Usage in Next.js App Router:
+ * ```typescript
+ * // app/api/checkout/shipping/route.ts
+ * export { ShippingPOST as POST } from '@rovela/sdk/checkout/api'
+ * ```
+ */
+import { NextResponse } from 'next/server';
+import { findSettings, findShippingOptionsForCountry, findTaxRateForAddress } from '../../core/db/queries';
+import { getShippoRates, groupShippoRatesByCarrier, shippingAddressToShippo, } from '../../shipping/shippo';
+import { countryRequiresState } from '../constants';
+// =============================================================================
+// Handler
+// =============================================================================
+/**
+ * POST /api/checkout/shipping
+ *
+ * Calculate available shipping options based on destination address.
+ * Automatically switches between manual (zones/rates) and Shippo (carrier API)
+ * modes based on store settings.
+ *
+ * Request Body:
+ * - address: Full shipping address (required)
+ * - items: Array of { price, quantity } for order total calculation (required)
+ *
+ * Response:
+ * - success: boolean
+ * - options: ShippingOptionsGroupedByCarrier[]
+ * - flatOptions: ShippingOption[]
+ * - mode: 'manual' | 'shippo'
+ * - error?: string (if calculation failed)
+ */
+export async function POST(request) {
+    try {
+        const body = (await request.json());
+        // Validate address
+        if (!body.address) {
+            return NextResponse.json({ error: 'Address is required', code: 'INVALID_REQUEST' }, { status: 400 });
+        }
+        const { address, items } = body;
+        // Validate required address fields
+        if (!address.firstName || !address.lastName) {
+            return NextResponse.json({ error: 'First name and last name are required', code: 'INVALID_REQUEST' }, { status: 400 });
+        }
+        // State is only required for countries that have states (e.g., US)
+        const stateRequired = countryRequiresState(address.country || '');
+        if (!address.line1 || !address.city || (stateRequired && !address.state) || !address.postalCode || !address.country) {
+            const requiredFields = ['line1', 'city', 'postalCode', 'country'];
+            if (stateRequired)
+                requiredFields.splice(2, 0, 'state'); // Insert state after city
+            return NextResponse.json({ error: `Complete address is required (${requiredFields.join(', ')})`, code: 'INVALID_REQUEST' }, { status: 400 });
+        }
+        // Validate items
+        if (!items || !Array.isArray(items) || items.length === 0) {
+            return NextResponse.json({ error: 'Items array is required for order total calculation', code: 'INVALID_REQUEST' }, { status: 400 });
+        }
+        // Calculate order total in cents (items come from useCheckout with prices in cents)
+        const orderAmountCents = items.reduce((sum, item) => sum + (item.price * item.quantity), 0);
+        // Convert to dollars for DB queries (min/max order amounts are stored in dollars)
+        const orderAmountDollars = orderAmountCents / 100;
+        // Fetch store settings to determine shipping mode
+        const settings = await findSettings();
+        const shippingMode = settings?.shippingMode || 'manual';
+        const shippingEnabled = settings?.shippingEnabled ?? true;
+        if (!shippingEnabled) {
+            return NextResponse.json({
+                success: true,
+                options: [],
+                flatOptions: [],
+                mode: shippingMode,
+                error: 'Shipping is not enabled for this store',
+            });
+        }
+        let groupedOptions = [];
+        if (shippingMode === 'shippo') {
+            // =======================================================================
+            // Shippo Mode: Get real-time carrier rates
+            // =======================================================================
+            const shippoFromAddress = settings?.shippoFromAddress;
+            const shippoDefaultParcel = settings?.shippoDefaultParcel;
+            if (!shippoFromAddress) {
+                return NextResponse.json({
+                    success: false,
+                    options: [],
+                    flatOptions: [],
+                    mode: 'shippo',
+                    error: 'Shippo is not properly configured. Store address is missing.',
+                });
+            }
+            if (!shippoDefaultParcel) {
+                return NextResponse.json({
+                    success: false,
+                    options: [],
+                    flatOptions: [],
+                    mode: 'shippo',
+                    error: 'Shippo is not properly configured. Default parcel dimensions are missing.',
+                });
+            }
+            try {
+                // Convert our ShippingAddress to Shippo format
+                const toAddress = shippingAddressToShippo(address);
+                // Get rates from Shippo
+                const rates = await getShippoRates({
+                    fromAddress: shippoFromAddress,
+                    toAddress,
+                    parcel: shippoDefaultParcel,
+                });
+                // Group rates by carrier for consistent UI
+                groupedOptions = groupShippoRatesByCarrier(rates);
+            }
+            catch (error) {
+                console.error('[Shipping API] Shippo error:', error);
+                return NextResponse.json({
+                    success: false,
+                    options: [],
+                    flatOptions: [],
+                    mode: 'shippo',
+                    error: error instanceof Error
+                        ? `Failed to get carrier rates: ${error.message}`
+                        : 'Failed to get carrier rates',
+                });
+            }
+        }
+        else {
+            // =======================================================================
+            // Manual Mode: Use configured zones and rates
+            // =======================================================================
+            try {
+                // Convert country code to uppercase for consistency
+                const country = address.country.toUpperCase();
+                // Get shipping options for this country and order amount (in dollars for DB query)
+                const dbOptions = await findShippingOptionsForCountry(country, orderAmountDollars);
+                // Convert prices from dollars (DB storage) to cents (frontend/Stripe expects cents)
+                groupedOptions = dbOptions.map(group => ({
+                    ...group,
+                    options: group.options.map(opt => ({
+                        ...opt,
+                        price: Math.round(opt.price * 100), // dollars to cents
+                    })),
+                }));
+                // Check for free shipping threshold
+                const freeShippingThreshold = settings?.freeShippingThreshold;
+                if (freeShippingThreshold && orderAmountDollars >= freeShippingThreshold) {
+                    // Add free shipping option at the start
+                    const currency = settings?.storeCurrency || 'USD';
+                    const formattedThreshold = new Intl.NumberFormat('en-US', {
+                        style: 'currency',
+                        currency: currency,
+                    }).format(freeShippingThreshold);
+                    const freeShippingGroup = {
+                        carrier: {
+                            id: 'free-shipping',
+                            name: 'Free Shipping',
+                            code: 'free-shipping',
+                        },
+                        options: [
+                            {
+                                id: 'free-shipping',
+                                carrierName: 'Free Shipping',
+                                carrierCode: 'free-shipping',
+                                name: 'Free Shipping',
+                                description: `Free shipping on orders over ${formattedThreshold}`,
+                                price: 0,
+                                estimatedDays: '5-7',
+                                source: 'manual',
+                            },
+                        ],
+                    };
+                    groupedOptions = [freeShippingGroup, ...groupedOptions];
+                }
+            }
+            catch (error) {
+                console.error('[Shipping API] Manual mode error:', error);
+                return NextResponse.json({
+                    success: false,
+                    options: [],
+                    flatOptions: [],
+                    mode: 'manual',
+                    error: error instanceof Error
+                        ? `Failed to calculate shipping: ${error.message}`
+                        : 'Failed to calculate shipping',
+                });
+            }
+        }
+        // Flatten options for convenience
+        const flatOptions = groupedOptions.flatMap((group) => group.options);
+        // =========================================================================
+        // Calculate Tax
+        // =========================================================================
+        let tax = null;
+        try {
+            // Look up tax zone for the customer's address
+            const taxMatch = await findTaxRateForAddress(address.country.toUpperCase(), address.state?.toUpperCase());
+            if (taxMatch && taxMatch.taxRate > 0) {
+                const taxIncludedInPrices = settings?.taxIncludedInPrices ?? true;
+                const taxRate = taxMatch.taxRate; // Percentage (e.g., 8.25 = 8.25%)
+                // Calculate tax based on mode
+                // Note: orderAmountCents is the subtotal, tax applies to subtotal only
+                // (Shipping tax calculation can be added later if needed)
+                let taxAmountCents;
+                if (taxIncludedInPrices) {
+                    // Prices already include tax - extract the tax portion
+                    // Formula: taxAmount = subtotal - (subtotal / (1 + taxRate/100))
+                    const taxDivisor = 1 + (taxRate / 100);
+                    const preTaxAmount = orderAmountCents / taxDivisor;
+                    taxAmountCents = Math.round(orderAmountCents - preTaxAmount);
+                }
+                else {
+                    // Prices are pre-tax - add tax on top
+                    // Formula: taxAmount = subtotal * (taxRate/100)
+                    taxAmountCents = Math.round(orderAmountCents * (taxRate / 100));
+                }
+                tax = {
+                    zoneId: taxMatch.zoneId,
+                    zoneName: taxMatch.zoneName,
+                    taxRate: taxRate,
+                    amount: taxAmountCents,
+                    includedInPrices: taxIncludedInPrices,
+                };
+            }
+        }
+        catch (error) {
+            // Tax calculation is non-fatal - log and continue with no tax
+            console.warn('[Shipping API] Tax calculation error:', error);
+        }
+        return NextResponse.json({
+            success: true,
+            options: groupedOptions,
+            flatOptions,
+            mode: shippingMode,
+            tax,
+        });
+    }
+    catch (error) {
+        console.error('[Shipping API] Error:', error);
+        return NextResponse.json({
+            error: 'Failed to calculate shipping options. Please try again.',
+            code: 'CHECKOUT_ERROR',
+        }, { status: 500 });
+    }
+}
+//# sourceMappingURL=shipping.js.map

package/dist/checkout/api/shipping.js.map

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

package/dist/checkout/api/webhook.js

@@ -0,0 +1,55 @@
+/**
+ * @rovela/sdk/checkout/api/webhook
+ *
+ * API route handler for Stripe webhooks.
+ *
+ * Usage in Next.js App Router:
+ * ```typescript
+ * // app/api/webhooks/stripe/route.ts
+ * export { POST } from '@rovela/sdk/checkout/api'
+ * ```
+ */
+import { NextResponse } from 'next/server';
+import { handleStripeWebhook } from '../server/handle-webhook';
+// =============================================================================
+// Handler
+// =============================================================================
+/**
+ * POST /api/webhooks/stripe
+ *
+ * Handles incoming Stripe webhook events.
+ * Verifies the signature and processes the event.
+ *
+ * Required Headers:
+ * - stripe-signature: Webhook signature from Stripe
+ *
+ * Response:
+ * - received: Whether the event was received
+ * - event: The event type (if processed)
+ * - orderId: The order ID (if created)
+ * - error: Error message (if failed)
+ */
+export async function POST(request) {
+    // Get raw body for signature verification
+    const payload = await request.text();
+    // Get signature header
+    const signature = request.headers.get('stripe-signature');
+    if (!signature) {
+        console.error('[Webhook] Missing stripe-signature header');
+        return NextResponse.json({ received: false, error: 'Missing stripe-signature header' }, { status: 400 });
+    }
+    // Process the webhook
+    const result = await handleStripeWebhook(payload, signature);
+    // Return appropriate status based on result
+    if (!result.received) {
+        return NextResponse.json(result, { status: 400 });
+    }
+    if (result.error) {
+        // Event received but processing failed - return 200 to prevent retries
+        // for non-recoverable errors (Stripe will retry on 5xx)
+        console.warn('[Webhook] Processing error:', result.error);
+        return NextResponse.json(result, { status: 200 });
+    }
+    return NextResponse.json(result, { status: 200 });
+}
+//# sourceMappingURL=webhook.js.map

package/dist/checkout/api/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../../src/checkout/api/webhook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAe,YAAY,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAG9D,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,OAAoB;IAEpB,0CAA0C;IAC1C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAA;IAEpC,uBAAuB;IACvB,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;IAEzD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAA;QAC1D,OAAO,YAAY,CAAC,IAAI,CACtB,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,iCAAiC,EAAE,EAC7D,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAA;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAE5D,4CAA4C;IAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;IACnD,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,uEAAuE;QACvE,wDAAwD;QACxD,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACzD,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;AACnD,CAAC"}

package/dist/checkout/components/CheckoutButton.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @rovela/sdk/checkout/components/CheckoutButton
+ *
+ * Button that initiates Stripe Checkout.
+ * Automatically checks payment configuration and shows appropriate state.
+ */
+import type { CheckoutButtonProps } from '../types';
+/**
+ * Button that initiates Stripe Checkout with cart items.
+ *
+ * Automatically checks if payments are configured and shows appropriate state:
+ * - If payments are active: Shows normal checkout button
+ * - If payments are not configured: Shows disabled state with message
+ * - If loading: Shows loading state
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { CheckoutButton } from '@rovela/sdk/checkout'
+ *
+ * function Cart() {
+ *   return (
+ *     <div>
+ *       <CartItems />
+ *       <CheckoutButton />
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * @example With custom content
+ * ```tsx
+ * <CheckoutButton size="lg" fullWidth>
+ *   Proceed to Payment
+ * </CheckoutButton>
+ * ```
+ *
+ * @example With callbacks
+ * ```tsx
+ * <CheckoutButton
+ *   onBeforeCheckout={async () => {
+ *     await saveCart()
+ *   }}
+ *   onError={(error) => {
+ *     showToast(error.message)
+ *   }}
+ * />
+ * ```
+ *
+ * @example Skip payment status check (for faster UX if you know payments are configured)
+ * ```tsx
+ * <CheckoutButton skipPaymentCheck />
+ * ```
+ */
+export declare function CheckoutButton({ children, disabled, className, onBeforeCheckout, onError, size, fullWidth, skipPaymentCheck, }: CheckoutButtonProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CheckoutButton.d.ts.map

package/dist/checkout/components/CheckoutButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckoutButton.d.ts","sourceRoot":"","sources":["../../../src/checkout/components/CheckoutButton.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAMnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAqB,EACrB,QAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,IAAW,EACX,SAAiB,EACjB,gBAAwB,GACzB,EAAE,mBAAmB,2CA+HrB"}

package/dist/checkout/components/CheckoutButton.js

@@ -0,0 +1,132 @@
+/**
+ * @rovela/sdk/checkout/components/CheckoutButton
+ *
+ * Button that initiates Stripe Checkout.
+ * Automatically checks payment configuration and shows appropriate state.
+ */
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Loader2, AlertCircle } from 'lucide-react';
+import { useCheckout } from '../hooks/useCheckout';
+import { usePaymentStatus } from '../hooks/usePaymentStatus';
+import { cn } from '../../core/utils';
+// =============================================================================
+// Component
+// =============================================================================
+/**
+ * Button that initiates Stripe Checkout with cart items.
+ *
+ * Automatically checks if payments are configured and shows appropriate state:
+ * - If payments are active: Shows normal checkout button
+ * - If payments are not configured: Shows disabled state with message
+ * - If loading: Shows loading state
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { CheckoutButton } from '@rovela/sdk/checkout'
+ *
+ * function Cart() {
+ *   return (
+ *     <div>
+ *       <CartItems />
+ *       <CheckoutButton />
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * @example With custom content
+ * ```tsx
+ * <CheckoutButton size="lg" fullWidth>
+ *   Proceed to Payment
+ * </CheckoutButton>
+ * ```
+ *
+ * @example With callbacks
+ * ```tsx
+ * <CheckoutButton
+ *   onBeforeCheckout={async () => {
+ *     await saveCart()
+ *   }}
+ *   onError={(error) => {
+ *     showToast(error.message)
+ *   }}
+ * />
+ * ```
+ *
+ * @example Skip payment status check (for faster UX if you know payments are configured)
+ * ```tsx
+ * <CheckoutButton skipPaymentCheck />
+ * ```
+ */
+export function CheckoutButton({ children = 'Checkout', disabled = false, className, onBeforeCheckout, onError, size = 'md', fullWidth = false, skipPaymentCheck = false, }) {
+    const paymentStatus = usePaymentStatus();
+    const { checkout, isLoading } = useCheckout({
+        onError: (err) => {
+            if (onError) {
+                // Provide user-friendly message for guest checkout disabled
+                if (err.code === 'GUEST_CHECKOUT_DISABLED') {
+                    onError(new Error('Please sign in to continue. Guest checkout is disabled for this store.'));
+                }
+                else {
+                    onError(new Error(err.error));
+                }
+            }
+        },
+    });
+    // Check if payments are unavailable
+    const paymentsUnavailable = !skipPaymentCheck && !paymentStatus.isLoading && !paymentStatus.canAcceptPayments;
+    const handleClick = async () => {
+        try {
+            if (onBeforeCheckout) {
+                await onBeforeCheckout();
+            }
+            await checkout();
+        }
+        catch (err) {
+            if (onError && err instanceof Error) {
+                onError(err);
+            }
+        }
+    };
+    // Size classes
+    const sizeClasses = {
+        sm: 'px-4 py-2 text-sm',
+        md: 'px-6 py-3 text-base',
+        lg: 'px-8 py-4 text-lg',
+    };
+    // If payments are unavailable, show a disabled state with message
+    if (paymentsUnavailable) {
+        return (_jsxs("div", { className: cn('flex flex-col gap-2', fullWidth && 'w-full'), children: [_jsxs("button", { type: "button", disabled: true, className: cn(
+                    // Base styles
+                    'inline-flex items-center justify-center', 'rounded-md font-medium transition-colors', 
+                    // Disabled styles - muted appearance
+                    'bg-muted text-muted-foreground', 'cursor-not-allowed opacity-60', 
+                    // Size
+                    sizeClasses[size], 
+                    // Width
+                    fullWidth && 'w-full', className), children: [_jsx(AlertCircle, { className: "h-4 w-4 mr-2" }), "Checkout Unavailable"] }), _jsx("p", { className: "text-xs text-muted-foreground text-center", children: paymentStatus.message })] }));
+    }
+    // Show loading state while checking payment status
+    if (!skipPaymentCheck && paymentStatus.isLoading) {
+        return (_jsxs("button", { type: "button", disabled: true, className: cn(
+            // Base styles
+            'inline-flex items-center justify-center', 'rounded-md font-medium transition-colors', 'bg-primary text-primary-foreground', 'opacity-70 cursor-wait', 
+            // Size
+            sizeClasses[size], 
+            // Width
+            fullWidth && 'w-full', className), children: [_jsx(Loader2, { className: "h-4 w-4 animate-spin mr-2" }), "Loading..."] }));
+    }
+    return (_jsx("button", { type: "button", onClick: handleClick, disabled: disabled || isLoading, className: cn(
+        // Base styles
+        'inline-flex items-center justify-center', 'rounded-md font-medium transition-colors', 'focus:outline-none focus:ring-2 focus:ring-offset-2', 
+        // Colors
+        'bg-primary text-primary-foreground', 'hover:bg-primary/90', 'focus:ring-primary', 
+        // Disabled
+        'disabled:opacity-50 disabled:cursor-not-allowed', 
+        // Size
+        sizeClasses[size], 
+        // Width
+        fullWidth && 'w-full', className), children: isLoading ? (_jsxs(_Fragment, { children: [_jsx(Loader2, { className: "h-4 w-4 animate-spin mr-2" }), "Redirecting..."] })) : (children) }));
+}
+//# sourceMappingURL=CheckoutButton.js.map