@rovela-ai/sdk 0.4.1 → 0.4.2

package/dist/checkout/types.d.ts

@@ -0,0 +1,489 @@
+/**
+ * @rovela/sdk/checkout/types
+ *
+ * Type definitions for the checkout module.
+ * Stripe Connect with Direct Charges and platform fees.
+ */
+import type { Address } from '../core/types';
+/**
+ * Line item for checkout session creation.
+ * Prices are in cents (e.g., 1999 = $19.99)
+ */
+export interface CheckoutLineItem {
+    /** Product ID from database */
+    productId?: string;
+    /** Variant ID if applicable */
+    variantId?: string;
+    /** Display name */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** Price in cents */
+    price: number;
+    /** Quantity */
+    quantity: number;
+    /** Product image URL */
+    image?: string;
+    /** Variant attributes */
+    attributes?: Record<string, string>;
+}
+/**
+ * Request to create a Stripe Checkout session
+ */
+export interface CheckoutSessionRequest {
+    /** Items to purchase */
+    items: CheckoutLineItem[];
+    /** Customer email (optional, will be collected if not provided) */
+    customerEmail?: string;
+    /** Store customer ID (if authenticated) */
+    customerId?: string;
+    /**
+     * Pre-collected shipping address from pre-checkout flow.
+     * When provided, this address is attached to the payment intent
+     * and used for order fulfillment.
+     */
+    shippingAddress?: Address;
+    /**
+     * Pre-selected shipping option from pre-checkout flow.
+     * When provided, shipping is added as a line item (not selectable by customer)
+     * and the shipping_options array is NOT shown in Stripe Checkout.
+     */
+    selectedShipping?: ShippingOption;
+    /** URL to redirect on success (must include {CHECKOUT_SESSION_ID} placeholder) */
+    successUrl: string;
+    /** URL to redirect on cancel */
+    cancelUrl: string;
+    /** Custom metadata to attach to the session */
+    metadata?: Record<string, string>;
+}
+/**
+ * Response from checkout session creation
+ */
+export interface CheckoutSessionResponse {
+    /** Stripe Checkout session ID */
+    sessionId: string;
+    /** URL to redirect customer to Stripe Checkout */
+    url: string;
+}
+/**
+ * Error response from checkout API
+ */
+export interface CheckoutApiError {
+    /** Error message */
+    error: string;
+    /** Error code for programmatic handling */
+    code: 'EMPTY_CART' | 'INVALID_REQUEST' | 'STRIPE_NOT_CONFIGURED' | 'ACCOUNT_NOT_CONNECTED' | 'CHECKOUT_ERROR' | 'WEBHOOK_ERROR' | 'SIGNATURE_INVALID' | 'GUEST_CHECKOUT_DISABLED';
+}
+/**
+ * Parameters for creating an order from a completed checkout session
+ */
+export interface CreateOrderParams {
+    /** Stripe Checkout session ID */
+    sessionId: string;
+    /** Customer email */
+    email: string;
+    /** Line items from the checkout */
+    items: CheckoutLineItem[];
+    /** Subtotal in cents */
+    subtotal: number;
+    /** Tax amount in cents */
+    tax: number;
+    /** Shipping amount in cents */
+    shipping: number;
+    /** Discount code applied (if any) */
+    discountCode?: string;
+    /** Discount amount in cents */
+    discountAmount?: number;
+    /** Stripe promotion code ID */
+    stripePromotionCodeId?: string;
+    /** Total amount in cents */
+    total: number;
+    /** Shipping address */
+    shippingAddress: Address;
+    /** Billing address (optional) */
+    billingAddress?: Address;
+    /** Stripe Payment Intent ID */
+    stripePaymentIntentId: string;
+    /** Stripe Customer ID (if customer was created) */
+    stripeCustomerId?: string;
+    /** Store customer ID (if authenticated) */
+    customerId?: string;
+    /** Shipping method display name (e.g., "Colissimo - Domicile") */
+    shippingMethod?: string;
+    /** Carrier code (e.g., "colissimo", "usps") */
+    carrier?: string;
+    /** Shippo rate object ID (for Shippo-sourced shipping) */
+    shippoRateId?: string;
+}
+/**
+ * Result from processing a webhook
+ */
+export interface WebhookResult {
+    /** Whether the webhook was received and processed */
+    received: boolean;
+    /** The event type that was processed */
+    event?: string;
+    /** Order ID if an order was created */
+    orderId?: string;
+    /** Error message if processing failed */
+    error?: string;
+}
+/**
+ * Checkout flow steps
+ */
+export type CheckoutStep = 'cart' | 'information' | 'shipping' | 'payment' | 'success';
+/**
+ * Shipping option returned from calculation.
+ * Unified interface for both manual (zones/rates) and Shippo (carrier API) modes.
+ */
+export interface ShippingOption {
+    /** Unique identifier (rate ID for manual, Shippo object_id for Shippo) */
+    id: string;
+    /** Carrier ID (for manual mode grouping) */
+    carrierId?: string;
+    /** Carrier name (e.g., "USPS", "FedEx", "Local Delivery") */
+    carrierName?: string;
+    /** Carrier code (for programmatic reference) */
+    carrierCode?: string;
+    /** Display name (e.g., "Standard Shipping", "Priority Mail") */
+    name: string;
+    /** Description (e.g., "5-7 business days") */
+    description?: string;
+    /** Price in cents */
+    price: number;
+    /** Estimated delivery time */
+    estimatedDays?: string;
+    /** Source of the shipping option */
+    source: 'manual' | 'shippo';
+}
+/**
+ * Shipping options grouped by carrier.
+ * Used for displaying shipping options in a carrier-first UI.
+ */
+export interface ShippingOptionsGroupedByCarrier {
+    carrier: {
+        id: string;
+        name: string;
+        code: string;
+    };
+    options: ShippingOption[];
+}
+/**
+ * Tax calculation result from the shipping API.
+ * Returned alongside shipping options for order summary display.
+ */
+export interface TaxCalculation {
+    /** Tax zone ID */
+    zoneId: string;
+    /** Tax zone name for display (e.g., "US - California") */
+    zoneName: string;
+    /** Tax rate as percentage (e.g., 8.25 = 8.25%) */
+    taxRate: number;
+    /** Calculated tax amount in cents */
+    amount: number;
+    /** Whether tax is included in product prices */
+    includedInPrices: boolean;
+}
+/**
+ * Shipping address for rate calculation.
+ * Compatible with Address type but uses shipping-specific field names.
+ */
+export interface ShippingAddress {
+    /** First name */
+    firstName: string;
+    /** Last name */
+    lastName: string;
+    /** Address line 1 */
+    line1: string;
+    /** Address line 2 (optional) */
+    line2?: string;
+    /** City */
+    city: string;
+    /** State/province */
+    state: string;
+    /** Postal/ZIP code */
+    postalCode: string;
+    /** Country code (ISO 3166-1 alpha-2, e.g., "US", "CA") */
+    country: string;
+    /** Phone number (optional) */
+    phone?: string;
+    /** Email address (optional, for Shippo notifications) */
+    email?: string;
+}
+/**
+ * Request to calculate shipping options based on address.
+ * Used by the pre-checkout flow to get available shipping rates.
+ */
+export interface ShippingCalculationRequest {
+    /** Full shipping address for accurate rate calculation */
+    address: ShippingAddress;
+    /** Line items for order total calculation */
+    items: Array<{
+        /** Price in cents */
+        price: number;
+        /** Quantity */
+        quantity: number;
+    }>;
+}
+/**
+ * Response from shipping calculation.
+ * Includes tax calculation when a matching tax zone is found.
+ */
+export interface ShippingCalculationResponse {
+    /** Whether calculation was successful */
+    success: boolean;
+    /** Available shipping options grouped by carrier */
+    options: ShippingOptionsGroupedByCarrier[];
+    /** Flat list of all options (convenience accessor) */
+    flatOptions: ShippingOption[];
+    /** Shipping mode used */
+    mode: 'manual' | 'shippo';
+    /** Error message if calculation failed */
+    error?: string;
+    /** Tax calculation result (null if no tax zone matches or tax rate is 0) */
+    tax?: TaxCalculation | null;
+}
+/**
+ * Checkout state for the useCheckout hook
+ */
+export interface CheckoutState {
+    /** Current step in checkout flow */
+    step: CheckoutStep;
+    /** Customer email */
+    email: string | null;
+    /** Shipping address */
+    shippingAddress: Address | null;
+    /** Billing address (if different from shipping) */
+    billingAddress: Address | null;
+    /** Selected shipping option */
+    selectedShipping: ShippingOption | null;
+    /** Whether checkout is processing */
+    isProcessing: boolean;
+    /** Error message if any */
+    error: string | null;
+}
+/**
+ * Props for CheckoutButton component
+ */
+export interface CheckoutButtonProps {
+    /** Button text (default: "Checkout") */
+    children?: React.ReactNode;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Custom className */
+    className?: string;
+    /** Callback before redirect */
+    onBeforeCheckout?: () => void | Promise<void>;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Full width */
+    fullWidth?: boolean;
+    /**
+     * Skip the payment status check (for faster UX when you know payments are configured).
+     * When false (default), the button checks /api/checkout/status to verify payments are available.
+     * When true, skips the check and assumes payments are configured.
+     */
+    skipPaymentCheck?: boolean;
+}
+/**
+ * Props for ShippingForm component
+ */
+export interface ShippingFormProps {
+    /** Initial values */
+    defaultValues?: Partial<Address>;
+    /** Callback on valid submission */
+    onSubmit: (address: Address) => void;
+    /** Callback on cancel */
+    onCancel?: () => void;
+    /** Whether form is submitting */
+    isSubmitting?: boolean;
+    /** Custom className */
+    className?: string;
+    /** Show billing address option */
+    showBillingAddress?: boolean;
+    /** Callback when billing address is different */
+    onBillingAddressChange?: (address: Address | null) => void;
+    /**
+     * Allowed shipping countries (ISO 3166-1 alpha-2 codes), fetched from
+     * `store_settings.shippingCountries`. When provided, only these countries
+     * are shown in the dropdown. When omitted (settings fetch failed or
+     * unconfigured store), falls back to the full COMMON_COUNTRIES list.
+     */
+    allowedCountries?: string[];
+}
+/**
+ * Props for OrderSummary component
+ */
+export interface OrderSummaryProps {
+    /** Line items to display */
+    items?: CheckoutLineItem[];
+    /** Subtotal in cents */
+    subtotal?: number;
+    /** Shipping cost in cents */
+    shipping?: number;
+    /** Tax in cents */
+    tax?: number;
+    /** Discount in cents */
+    discount?: number;
+    /** Total in cents */
+    total?: number;
+    /** Currency code */
+    currency?: string;
+    /** Locale for formatting */
+    locale?: string;
+    /** Custom className */
+    className?: string;
+    /** Whether to show item details */
+    showItems?: boolean;
+    /** Whether to show edit link */
+    showEditLink?: boolean;
+    /** Edit link href */
+    editHref?: string;
+}
+/**
+ * Props for CheckoutSuccess component
+ */
+export interface CheckoutSuccessProps {
+    /** Order ID to display */
+    orderId?: string;
+    /** Customer email for order updates */
+    email?: string;
+    /** Custom className */
+    className?: string;
+    /** Continue shopping link */
+    continueShoppingHref?: string;
+    /** View order link pattern */
+    viewOrderHref?: string;
+    /** Callback on mount (useful for cart clearing) */
+    onMount?: () => void;
+}
+/**
+ * Props for ShippingOptions component.
+ * Displays shipping options grouped by carrier with selection.
+ */
+export interface ShippingOptionsProps {
+    /** Shipping options grouped by carrier */
+    options: ShippingOptionsGroupedByCarrier[];
+    /** Currently selected option */
+    selectedOption?: ShippingOption | null;
+    /** Callback when an option is selected */
+    onSelect: (option: ShippingOption) => void;
+    /** Whether options are loading */
+    isLoading?: boolean;
+    /** Error message to display */
+    error?: string | null;
+    /** Custom className */
+    className?: string;
+    /** Currency code for price formatting (default: 'USD') */
+    currency?: string;
+    /** Locale for formatting (default: 'en-US') */
+    locale?: string;
+    /** Whether to show carrier grouping (default: true) */
+    showCarrierGroups?: boolean;
+    /** Custom empty state message */
+    emptyMessage?: string;
+}
+/**
+ * Props for CheckoutFlow component.
+ * Unified pre-checkout flow: Address → Shipping → Review → Payment
+ */
+export interface CheckoutFlowProps {
+    /** Called when checkout flow is complete (redirects to Stripe) */
+    onComplete?: () => void;
+    /** Called when user cancels checkout */
+    onCancel?: () => void;
+    /** Initial customer email (if authenticated) */
+    customerEmail?: string;
+    /** Store customer ID (if authenticated) */
+    customerId?: string;
+    /** Custom success URL for Stripe redirect */
+    successUrl?: string;
+    /** Custom cancel URL for Stripe redirect */
+    cancelUrl?: string;
+    /** Custom className */
+    className?: string;
+    /** Whether to show order summary sidebar */
+    showOrderSummary?: boolean;
+    /** Currency code */
+    currency?: string;
+    /** Custom metadata for the checkout session */
+    metadata?: Record<string, string>;
+}
+/**
+ * State for the CheckoutFlow component.
+ */
+export interface CheckoutFlowState {
+    /** Current step in the pre-checkout flow */
+    step: 'address' | 'shipping' | 'review';
+    /** Customer email */
+    email: string | null;
+    /** Shipping address */
+    shippingAddress: Address | null;
+    /** Billing address (if different from shipping) */
+    billingAddress: Address | null;
+    /** Available shipping options (fetched after address is entered) */
+    availableShipping: ShippingOptionsGroupedByCarrier[];
+    /** Selected shipping option */
+    selectedShipping: ShippingOption | null;
+    /** Whether shipping options are loading */
+    isLoadingShipping: boolean;
+    /** Shipping calculation error */
+    shippingError: string | null;
+    /** Whether checkout is processing */
+    isProcessing: boolean;
+    /** General error message */
+    error: string | null;
+    /** Calculated tax amount in cents (0 if no tax zone matches) */
+    tax: number;
+    /** Tax rate as percentage (null if no tax zone) */
+    taxRate: number | null;
+    /** Tax zone name for display (null if no tax zone) */
+    taxZoneName: string | null;
+    /** Whether tax is included in product prices */
+    taxIncludedInPrices: boolean;
+}
+/**
+ * Options for the useCheckout hook
+ */
+export interface UseCheckoutOptions {
+    /** Customer email (if known) */
+    customerEmail?: string;
+    /** Store customer ID (if authenticated) */
+    customerId?: string;
+    /** Custom success URL */
+    successUrl?: string;
+    /** Custom cancel URL */
+    cancelUrl?: string;
+    /** Custom metadata */
+    metadata?: Record<string, string>;
+    /**
+     * Pre-collected shipping address from pre-checkout flow.
+     * When provided, Stripe Checkout will pre-fill this address.
+     */
+    shippingAddress?: Address;
+    /**
+     * Pre-selected shipping option from pre-checkout flow.
+     * When provided, creates a fixed shipping rate in Stripe instead of letting customer choose.
+     */
+    selectedShipping?: ShippingOption;
+    /** Callback on successful session creation (before redirect) */
+    onSuccess?: (session: CheckoutSessionResponse) => void;
+    /** Callback on error */
+    onError?: (error: CheckoutApiError) => void;
+}
+/**
+ * Return type for the useCheckout hook
+ */
+export interface UseCheckoutReturn {
+    /** Start checkout process */
+    checkout: () => Promise<void>;
+    /** Whether checkout is in progress */
+    isLoading: boolean;
+    /** Last error (if any) */
+    error: CheckoutApiError | null;
+    /** Clear error state */
+    clearError: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/checkout/types.js

@@ -0,0 +1,8 @@
+/**
+ * @rovela/sdk/checkout/types
+ *
+ * Type definitions for the checkout module.
+ * Stripe Connect with Direct Charges and platform fees.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/checkout/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/checkout/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/StoreSettingsProvider.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @rovela/sdk/core/StoreSettingsProvider
+ *
+ * React context provider for dynamic store settings.
+ * Fetches settings from the database and provides them to all components.
+ *
+ * Usage:
+ * ```tsx
+ * // app/layout.tsx
+ * import { StoreSettingsProvider } from '@rovela-ai/sdk/core'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <StoreSettingsProvider>
+ *           {children}
+ *         </StoreSettingsProvider>
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ *
+ * // In any component
+ * import { useStoreSettings } from '@rovela-ai/sdk/core'
+ *
+ * function MyComponent() {
+ *   const { storeName, currency, formatPrice, isLoading } = useStoreSettings()
+ *   return <h1>{storeName}</h1>
+ * }
+ * ```
+ */
+import { type ReactNode } from 'react';
+export interface StoreSettings {
+    storeName: string;
+    storeEmail: string;
+    logoUrl: string | null;
+    storeCurrency: string;
+    storeTimezone: string;
+    taxEnabled: boolean;
+    taxRate: number;
+    shippingEnabled: boolean;
+    freeShippingThreshold: number;
+}
+export interface StoreSettingsContextValue {
+    /** Store display name */
+    storeName: string;
+    /** Store logo URL */
+    logoUrl: string | null;
+    /** Store currency code (USD, EUR, etc.) */
+    currency: string;
+    /** Store locale for formatting */
+    locale: string;
+    /** Support email */
+    supportEmail: string;
+    /** Whether settings are still loading */
+    isLoading: boolean;
+    /** Error message if fetch failed */
+    error: string | null;
+    /** Full settings object */
+    settings: StoreSettings | null;
+    /** Format a price with the store's currency */
+    formatPrice: (price: number | string) => string;
+    /** Format a date with the store's timezone and locale */
+    formatDate: (date: Date | string, options?: Intl.DateTimeFormatOptions) => string;
+    /** Refetch settings from server */
+    refetch: () => Promise<void>;
+}
+export interface StoreSettingsProviderProps {
+    children: ReactNode;
+    /** Initial settings for SSR (optional) */
+    initialSettings?: Partial<StoreSettings>;
+    /** Fallback values when settings not available */
+    fallback?: {
+        storeName?: string;
+        currency?: string;
+        locale?: string;
+        supportEmail?: string;
+    };
+}
+export declare function StoreSettingsProvider({ children, initialSettings, fallback, }: StoreSettingsProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access store settings from context.
+ *
+ * @throws Error if used outside of StoreSettingsProvider
+ *
+ * @example
+ * ```tsx
+ * function PriceDisplay({ price }: { price: number }) {
+ *   const { formatPrice } = useStoreSettings()
+ *   return <span>{formatPrice(price)}</span>
+ * }
+ *
+ * function Header() {
+ *   const { storeName, isLoading } = useStoreSettings()
+ *   if (isLoading) return <Skeleton />
+ *   return <h1>{storeName}</h1>
+ * }
+ * ```
+ */
+export declare function useStoreSettings(): StoreSettingsContextValue;
+/**
+ * Optional hook that returns null instead of throwing if used outside provider.
+ * Useful for components that can work with or without settings.
+ */
+export declare function useStoreSettingsOptional(): StoreSettingsContextValue | null;
+//# sourceMappingURL=StoreSettingsProvider.d.ts.map

package/dist/core/StoreSettingsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoreSettingsProvider.d.ts","sourceRoot":"","sources":["../../src/core/StoreSettingsProvider.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AAMd,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,OAAO,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,OAAO,CAAA;IACxB,qBAAqB,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAA;IAClB,oCAAoC;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,2BAA2B;IAC3B,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAA;IAC9B,+CAA+C;IAC/C,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAA;IAC/C,yDAAyD;IACzD,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,KAAK,MAAM,CAAA;IACjF,mCAAmC;IACnC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,SAAS,CAAA;IACnB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IACxC,kDAAkD;IAClD,QAAQ,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;CACF;AAyCD,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,eAAe,EACf,QAAQ,GACT,EAAE,0BAA0B,2CA2H5B;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,IAAI,yBAAyB,CAW5D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,yBAAyB,GAAG,IAAI,CAE3E"}