@rovela-ai/sdk 0.1.2 → 0.1.3

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

@@ -0,0 +1,10 @@
+/**
+ * @rovela/sdk/checkout/components
+ *
+ * Checkout UI components
+ */
+export { CheckoutButton } from './CheckoutButton';
+export { CheckoutSuccess } from './CheckoutSuccess';
+export { OrderSummary } from './OrderSummary';
+export { ShippingForm } from './ShippingForm';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/checkout/components/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/checkout/components/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * @rovela/sdk/checkout/components
+ *
+ * Checkout UI components
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShippingForm = exports.OrderSummary = exports.CheckoutSuccess = exports.CheckoutButton = void 0;
+var CheckoutButton_1 = require("./CheckoutButton");
+Object.defineProperty(exports, "CheckoutButton", { enumerable: true, get: function () { return CheckoutButton_1.CheckoutButton; } });
+var CheckoutSuccess_1 = require("./CheckoutSuccess");
+Object.defineProperty(exports, "CheckoutSuccess", { enumerable: true, get: function () { return CheckoutSuccess_1.CheckoutSuccess; } });
+var OrderSummary_1 = require("./OrderSummary");
+Object.defineProperty(exports, "OrderSummary", { enumerable: true, get: function () { return OrderSummary_1.OrderSummary; } });
+var ShippingForm_1 = require("./ShippingForm");
+Object.defineProperty(exports, "ShippingForm", { enumerable: true, get: function () { return ShippingForm_1.ShippingForm; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/checkout/components/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,mDAAiD;AAAxC,gHAAA,cAAc,OAAA;AACvB,qDAAmD;AAA1C,kHAAA,eAAe,OAAA;AACxB,+CAA6C;AAApC,4GAAA,YAAY,OAAA;AACrB,+CAA6C;AAApC,4GAAA,YAAY,OAAA"}

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

@@ -0,0 +1,7 @@
+/**
+ * @rovela/sdk/checkout/hooks
+ *
+ * React hooks for checkout
+ */
+export { useCheckout, useCheckoutSuccess } from './useCheckout';
+//# 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,kBAAkB,EAAE,MAAM,eAAe,CAAA"}

package/dist/checkout/hooks/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * @rovela/sdk/checkout/hooks
+ *
+ * React hooks for checkout
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCheckoutSuccess = exports.useCheckout = void 0;
+var useCheckout_1 = require("./useCheckout");
+Object.defineProperty(exports, "useCheckout", { enumerable: true, get: function () { return useCheckout_1.useCheckout; } });
+Object.defineProperty(exports, "useCheckoutSuccess", { enumerable: true, get: function () { return useCheckout_1.useCheckoutSuccess; } });
+//# 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,6CAA+D;AAAtD,0GAAA,WAAW,OAAA;AAAE,iHAAA,kBAAkB,OAAA"}

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

@@ -0,0 +1,61 @@
+/**
+ * @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;
+/**
+ * Hook to retrieve checkout session details from URL.
+ * Used on success pages to display order confirmation.
+ *
+ * @example
+ * ```tsx
+ * // app/checkout/success/page.tsx
+ * 'use client'
+ *
+ * import { useCheckoutSuccess } from '@rovela/sdk/checkout'
+ *
+ * export default function SuccessPage() {
+ *   const { sessionId, isLoading, session } = useCheckoutSuccess()
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *
+ *   return <div>Thank you for your order! Session: {sessionId}</div>
+ * }
+ * ```
+ */
+export declare function useCheckoutSuccess(): {
+    sessionId: string | null;
+};
+//# 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,CA8F3E;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB;;EAgBjC"}

package/dist/checkout/hooks/useCheckout.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * @rovela/sdk/checkout/hooks/useCheckout
+ *
+ * React hook for initiating Stripe Checkout.
+ */
+'use client';
+/**
+ * @rovela/sdk/checkout/hooks/useCheckout
+ *
+ * React hook for initiating Stripe Checkout.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCheckout = useCheckout;
+exports.useCheckoutSuccess = useCheckoutSuccess;
+const react_1 = require("react");
+const store_1 = require("../../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',
+ * })
+ * ```
+ */
+function useCheckout(options) {
+    const { items, clearCart } = (0, store_1.useCart)();
+    const [isLoading, setIsLoading] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const checkout = (0, react_1.useCallback)(async () => {
+        // Reset error state
+        setError(null);
+        // 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,
+            };
+            // 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);
+            // Clear cart before redirect (optional behavior)
+            if (options?.clearCartOnCheckout !== false) {
+                clearCart();
+            }
+            // 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);
+        }
+    }, [items, clearCart, options]);
+    return {
+        checkout,
+        isLoading,
+        error,
+        clearError: (0, react_1.useCallback)(() => setError(null), []),
+    };
+}
+// =============================================================================
+// Additional Hooks
+// =============================================================================
+/**
+ * Hook to retrieve checkout session details from URL.
+ * Used on success pages to display order confirmation.
+ *
+ * @example
+ * ```tsx
+ * // app/checkout/success/page.tsx
+ * 'use client'
+ *
+ * import { useCheckoutSuccess } from '@rovela/sdk/checkout'
+ *
+ * export default function SuccessPage() {
+ *   const { sessionId, isLoading, session } = useCheckoutSuccess()
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *
+ *   return <div>Thank you for your order! Session: {sessionId}</div>
+ * }
+ * ```
+ */
+function useCheckoutSuccess() {
+    const [sessionId, setSessionId] = (0, react_1.useState)(null);
+    // Extract session_id from URL on mount
+    if (typeof window !== 'undefined' && !sessionId) {
+        const params = new URLSearchParams(window.location.search);
+        const id = params.get('session_id');
+        if (id) {
+            setSessionId(id);
+        }
+    }
+    return {
+        sessionId,
+        // Could be extended to fetch session details from API if needed
+    };
+}
+//# 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/index.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @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
+ */
+export type { CheckoutLineItem, CheckoutSessionRequest, CheckoutSessionResponse, CheckoutApiError, CreateOrderParams, WebhookResult, CheckoutStep, ShippingOption, CheckoutState, CheckoutButtonProps, ShippingFormProps, OrderSummaryProps, CheckoutSuccessProps, UseCheckoutOptions, UseCheckoutReturn, } from './types';
+export { CheckoutButton, CheckoutSuccess, OrderSummary, ShippingForm, } from './components';
+export { useCheckout, useCheckoutSuccess } from './hooks';
+export { createCheckoutSession, getCheckoutSession, createOrderFromCheckout, extractOrderParamsFromSession, handleRefund, handleStripeWebhook, } from './server';
+export type { CreateCheckoutSessionOptions } from './server';
+export { getStripe, getConnectedAccountId, hasConnectedAccount, getPlatformFeePercent, calculateApplicationFee, getWebhookSecret, getStoreCurrency, getAllowedShippingCountries, getPublishableKey, } from './stripe';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/checkout/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuGG;AAMH,YAAY,EAEV,gBAAgB,EAEhB,sBAAsB,EACtB,uBAAuB,EAEvB,gBAAgB,EAEhB,iBAAiB,EAEjB,aAAa,EAEb,YAAY,EACZ,cAAc,EACd,aAAa,EAEb,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EAEpB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,SAAS,CAAA;AAMhB,OAAO,EACL,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,GACb,MAAM,cAAc,CAAA;AAMrB,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAMzD,OAAO,EAEL,qBAAqB,EACrB,kBAAkB,EAElB,uBAAuB,EACvB,6BAA6B,EAC7B,YAAY,EAEZ,mBAAmB,GACpB,MAAM,UAAU,CAAA;AAEjB,YAAY,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAA;AAM5D,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,UAAU,CAAA"}

package/dist/checkout/index.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPublishableKey = exports.getAllowedShippingCountries = exports.getStoreCurrency = exports.getWebhookSecret = exports.calculateApplicationFee = exports.getPlatformFeePercent = exports.hasConnectedAccount = exports.getConnectedAccountId = exports.getStripe = exports.handleStripeWebhook = exports.handleRefund = exports.extractOrderParamsFromSession = exports.createOrderFromCheckout = exports.getCheckoutSession = exports.createCheckoutSession = exports.useCheckoutSuccess = exports.useCheckout = exports.ShippingForm = exports.OrderSummary = exports.CheckoutSuccess = exports.CheckoutButton = void 0;
+// =============================================================================
+// Components
+// =============================================================================
+var components_1 = require("./components");
+Object.defineProperty(exports, "CheckoutButton", { enumerable: true, get: function () { return components_1.CheckoutButton; } });
+Object.defineProperty(exports, "CheckoutSuccess", { enumerable: true, get: function () { return components_1.CheckoutSuccess; } });
+Object.defineProperty(exports, "OrderSummary", { enumerable: true, get: function () { return components_1.OrderSummary; } });
+Object.defineProperty(exports, "ShippingForm", { enumerable: true, get: function () { return components_1.ShippingForm; } });
+// =============================================================================
+// Hooks
+// =============================================================================
+var hooks_1 = require("./hooks");
+Object.defineProperty(exports, "useCheckout", { enumerable: true, get: function () { return hooks_1.useCheckout; } });
+Object.defineProperty(exports, "useCheckoutSuccess", { enumerable: true, get: function () { return hooks_1.useCheckoutSuccess; } });
+// =============================================================================
+// Server Functions
+// =============================================================================
+var server_1 = require("./server");
+// Session creation
+Object.defineProperty(exports, "createCheckoutSession", { enumerable: true, get: function () { return server_1.createCheckoutSession; } });
+Object.defineProperty(exports, "getCheckoutSession", { enumerable: true, get: function () { return server_1.getCheckoutSession; } });
+// Order management
+Object.defineProperty(exports, "createOrderFromCheckout", { enumerable: true, get: function () { return server_1.createOrderFromCheckout; } });
+Object.defineProperty(exports, "extractOrderParamsFromSession", { enumerable: true, get: function () { return server_1.extractOrderParamsFromSession; } });
+Object.defineProperty(exports, "handleRefund", { enumerable: true, get: function () { return server_1.handleRefund; } });
+// Webhook handler
+Object.defineProperty(exports, "handleStripeWebhook", { enumerable: true, get: function () { return server_1.handleStripeWebhook; } });
+// =============================================================================
+// Stripe Client Utilities
+// =============================================================================
+var stripe_1 = require("./stripe");
+Object.defineProperty(exports, "getStripe", { enumerable: true, get: function () { return stripe_1.getStripe; } });
+Object.defineProperty(exports, "getConnectedAccountId", { enumerable: true, get: function () { return stripe_1.getConnectedAccountId; } });
+Object.defineProperty(exports, "hasConnectedAccount", { enumerable: true, get: function () { return stripe_1.hasConnectedAccount; } });
+Object.defineProperty(exports, "getPlatformFeePercent", { enumerable: true, get: function () { return stripe_1.getPlatformFeePercent; } });
+Object.defineProperty(exports, "calculateApplicationFee", { enumerable: true, get: function () { return stripe_1.calculateApplicationFee; } });
+Object.defineProperty(exports, "getWebhookSecret", { enumerable: true, get: function () { return stripe_1.getWebhookSecret; } });
+Object.defineProperty(exports, "getStoreCurrency", { enumerable: true, get: function () { return stripe_1.getStoreCurrency; } });
+Object.defineProperty(exports, "getAllowedShippingCountries", { enumerable: true, get: function () { return stripe_1.getAllowedShippingCountries; } });
+Object.defineProperty(exports, "getPublishableKey", { enumerable: true, get: function () { return stripe_1.getPublishableKey; } });
+//# 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;;;AAgCH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,2CAKqB;AAJnB,4GAAA,cAAc,OAAA;AACd,6GAAA,eAAe,OAAA;AACf,0GAAA,YAAY,OAAA;AACZ,0GAAA,YAAY,OAAA;AAGd,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,iCAAyD;AAAhD,oGAAA,WAAW,OAAA;AAAE,2GAAA,kBAAkB,OAAA;AAExC,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,mCAUiB;AATf,mBAAmB;AACnB,+GAAA,qBAAqB,OAAA;AACrB,4GAAA,kBAAkB,OAAA;AAClB,mBAAmB;AACnB,iHAAA,uBAAuB,OAAA;AACvB,uHAAA,6BAA6B,OAAA;AAC7B,sGAAA,YAAY,OAAA;AACZ,kBAAkB;AAClB,6GAAA,mBAAmB,OAAA;AAKrB,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,mCAUiB;AATf,mGAAA,SAAS,OAAA;AACT,+GAAA,qBAAqB,OAAA;AACrB,6GAAA,mBAAmB,OAAA;AACnB,+GAAA,qBAAqB,OAAA;AACrB,iHAAA,uBAAuB,OAAA;AACvB,0GAAA,gBAAgB,OAAA;AAChB,0GAAA,gBAAgB,OAAA;AAChB,qHAAA,2BAA2B,OAAA;AAC3B,2GAAA,iBAAiB,OAAA"}

package/dist/checkout/server/create-checkout-session.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @rovela/sdk/checkout/server/create-checkout-session
+ *
+ * Creates a Stripe Checkout session using Direct Charges.
+ * The payment is processed ON the connected account, not the platform.
+ */
+import type Stripe from 'stripe';
+import type { CheckoutSessionRequest, CheckoutSessionResponse, CheckoutLineItem } from '../types';
+export interface CreateCheckoutSessionOptions {
+    /**
+     * Whether to collect shipping address.
+     * Default: true
+     */
+    collectShippingAddress?: boolean;
+    /**
+     * Whether to collect phone number.
+     * Default: false
+     */
+    collectPhoneNumber?: boolean;
+    /**
+     * Whether to allow promotion codes.
+     * Default: false
+     */
+    allowPromotionCodes?: boolean;
+    /**
+     * Automatic tax calculation.
+     * Requires Stripe Tax to be enabled.
+     * Default: false
+     */
+    automaticTax?: boolean;
+    /**
+     * Custom application fee in cents.
+     * If not provided, calculated from STRIPE_PLATFORM_FEE_PERCENT.
+     */
+    applicationFeeAmount?: number;
+}
+/**
+ * Create a Stripe Checkout session for Direct Charges.
+ *
+ * This creates the checkout session ON the connected account (Direct Charge),
+ * meaning the payment shows up in the connected account's dashboard, and
+ * the application fee is transferred to the platform.
+ *
+ * @example
+ * ```typescript
+ * const session = await createCheckoutSession({
+ *   items: [
+ *     { name: 'T-Shirt', price: 2999, quantity: 1 }
+ *   ],
+ *   customerEmail: 'customer@example.com',
+ *   successUrl: 'https://store.example.com/success?session_id={CHECKOUT_SESSION_ID}',
+ *   cancelUrl: 'https://store.example.com/cart',
+ * })
+ *
+ * // Redirect customer to Stripe Checkout
+ * redirect(session.url)
+ * ```
+ */
+export declare function createCheckoutSession(request: CheckoutSessionRequest, options?: CreateCheckoutSessionOptions): Promise<CheckoutSessionResponse>;
+/**
+ * Deserialize items from Stripe metadata.
+ */
+export declare function deserializeItemsFromMetadata(json: string): CheckoutLineItem[];
+/**
+ * Retrieve a checkout session by ID.
+ * Useful for the success page to get order details.
+ */
+export declare function getCheckoutSession(sessionId: string): Promise<Stripe.Checkout.Session | null>;
+//# sourceMappingURL=create-checkout-session.d.ts.map

package/dist/checkout/server/create-checkout-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-checkout-session.d.ts","sourceRoot":"","sources":["../../../src/checkout/server/create-checkout-session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAQhC,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,UAAU,CAAA;AAMjB,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAEhC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAE5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAE7B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IAEtB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,sBAAsB,EAC/B,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,uBAAuB,CAAC,CAsHlC;AA4BD;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,GACX,gBAAgB,EAAE,CAqBpB;AAMD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,CAoBzC"}